









Die Fachzeitschrift für ATARI ST- und TT-Anwender 


DM 14,- 


Ös. 112,- 
Sfr. 14,- 
Lit. 10000,- 


SONDERHEFT 
\BROGRAMMIER- 


> Grundlagen 
» Tips & Tricks 


{ 
{ 












Timer & Interrupts 
chnelle Grafik 


prachen- 
rweiterungen 


BRA & Cookie-Jar 
PX-Module 
olTrlululds 


tilities 





EDITORIAL 


Die 
Disketten- 
frage 


m Laufe der Zeit sammeln sich beim Programmieren eine Reihe von 

Routinen an. Manche sind nur auf eine spezielle Aufgabe ausgelegt und 

werden deshalb auch nur ein einziges Mal eingesetzt. Andere sind 

universell und können in fast allen Programmen wieder verwendet 

werden (z.B. eine Window-Bibliothek). Wir haben Ihnen in diesem Son- 
derheft eine Reihe von nützlichen Routinen und Bibliotheken zusammenge- 
stellt. Damit Sie diese sofort, ohne sie erst lange abtippen zu müssen, in Ihren 
eigenen Programmen anwenden könnnen, haben wir auf einen Abdruck der 
Listings verzichtet. Der dadurch gewonnene Platz kam weiteren Programmier- 
tips zugute. Die einzelnen Routinen finden Sie, nach den Sprachen sortiert, auf 
den Disketten zum Heft. Wir haben uns lange überlegt, ob wir die Disketten dem 
Heft beilegen sollen. Aus mehreren Gründen haben wir uns dagegen entschie- 
den. Die Routinen sind für drei Programmiersprachen (C, PASCAL und BASIC) 
vorhanden; es müßten demnach sechs Disketten dem Heft beigelegt werden. 
Abgesehen von dem zusätzlichen Gewicht, wäre es sicherlich nicht in jeder- 
mans Interesse, für sechs Disketten zu zahlen, wenn man die Routinen nur für 
eine Programmiersprache benötigt. Ein weiterer Grund liegt darin, daß nie alle 
Hefte einer Auflage verkauft werden. Die zurückgehenden Examplare werden 
normalerweise beim Zwischenhändler gesammelt und nur die Deckblätter an 
den Verlag zurückgeschickt. Bei beiliegenden Disketten müßte aber jeweils das 
gesamte Heft an den Verlag zurückgehen! Diesen Mehrkostenaufwand müßte 
auf den Preis dieses Sonderheftes umgerechnet werden, womit sicherlich 
keinem gedient wäre. 


Sie finden im Heft einen Bestellschein zum Bezug der Disketten. Alle Routinen 
(mit Ausnahme der Routinen aus dem Spracherweiterungsteil) sind in den drei 
Programmiersprachen erhältlich. Außerdem befinden sich die vorgestellten 
Utilities auf den Sprachendisketten. So können Sie die Routinen direkt bei der 
Entwicklung Ihres nächsten Programms verwenden. 


Thomas Werner 
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Mit der folgenden Übersicht wollen wir Ihnen eine Auswahl über die auf den ATARI-Rechnern 
verfügbaren Programmiersprachen, Erweiterungen und Utilities geben. In den drei Bereichen 
finden Sie jeweils kommerzielle und Public-Domain-Programme. 
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Grundlagen 


Bevor man sich an das Entwickeln eigener Programm begibt und dazu die in diesem Heft veröffent- 
lichten Programmiertips und -kniffe verwendet, sollte man sich ein Grundwissen über die Program- 
mierung des Rechners angeeignet haben. In dieser ersten Rubrik finden Sie deshalb einige Grund- 
lagenartikel. Sie behandeln neben rechnerspezifischen Themen (CPX, Cookie-Jar, Timer und 
Interrupts, XBRA, ...) auch das Betriebssystem der ATARI-Rechner (Programme unter GEM, Win- 
dow-Bibliothek, Submenüs). Die Beiträge können Ihnen zum Schreiben eigener Programme interes- 
sante Hilfestellungen und Tips vermitteln. 
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Programmierung von 
CPX-Modulen 


Neben der Überarbeitung der Hardware 
und des Betriebssystem hat ATARI den 


STE- und TT-Rechnern auch ein neues 
Kontrollfeld spendiert. Es ist modular u 5 


aufgebaut und kann somit auch vom 
Anwender erweitert werden. 


gramm XControl, welches für die 
Verwaltung der einzelnen Module 
zuständig ist und Funktionen zur Verfü- 
gung stellt, werden von ATARI bereits 
Module zur Rechnerkonfiguration mit- 
geliefert. Das modulare Kontrollfeldkann 
auch auf den ‘alten’ ST-Modellen ver- 
wendet werden; ATARI gibt dafür aller- 
dings keine 100% Funktionsgarantie. 
Das Kontrollfeld und die zusätzlichen 
Module (bis zu 99 können von XControl 
verwaltet werden) dienen außschließ- 
lich der Konfiguration des Rechners, 
von Programmen (z.B. Mausbeschleu- 
niger) und Zusatz-Hardware (z.B. Gra- 
fikkarten) und sollten auch zu keinem 
anderen Zweck verwendet werden. 


2 usammen mit dem Steuerpro- 


Wie funktioniert CPX? 


Nach dem Start des Rechners wird 
XControl geladen. Dieses sucht im CPX- 
Verzeichnis nach aktiven CPX(Control 
Panel eXtension)Modulen und lädt de- 
ren Header ein. Eventuell wird anschlie- 
Bend eine Initialisierungsroutine aufge- 
rufen, die jedem Modul die Möglichkeit 
zur Konfiguration gibt. Danach wartet 
XControl, wie jedes Accessory, auf sei- 
ne Aktivierung durch Anwahl in der 
Menüzeile. Wird ein Modul durch Aus- 
wählen in XControl aktiviert, wird zuerst 
seine Initialisierungroutine eine zweiten 
Mal aufgerufen. Hierbei müssen globa- 
le Variablen initialisiert werden. Darun- 
ter fallen auch sämtliche Resource-In- 
formationen, da diese im Modul enthal- 
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ten sein müssen [ein späteres Laden 
mittels rsrc_load() ist, durch die damit 
verbundene Zerstörung der Resource- 
Daten des momentan aktiven (Haupt-) 
Programms, nicht möglich]. Anschlie- 
Bend übergibt XConrol die Kontrolle an 
das Modul durch Aufruf seiner Haupt- 
routine. 


Modul-Aufbau 


Wie der obigen Beschreibung entnom- 
men werden kann, unterscheidet sich 
der Aufbau eines Moduls von demeines 
normalen Programms. Bei einer Modul- 
Datei befinden sich an erster Stelle der 
CPX-Header, 512 Bytes lang (Aufbau 
siehe Bild 1). Danach folgen der GEM- 
DOS-Programmheader, das Text- und 
Daten-Segment sowie Relozierungsin- 
formationen. Der CPX-Header enthält 
wichtige Information über das Modul, 
die von XControl benötigt werden. Ne- 
ben den Informationen über die Dar- 
stellung innerhalb des Kontrollfeldes 
befinden sich auch Daten über die Art 
des Moduls darin. Ein Flag zeigt z.B. an, 
ob das Modul resident im Speicher ge- 
halten werden soll (dann wird bei der 
Initialisierung nicht nur der Header, son- 
dern das ganze Modul in den Speicher 
geladen!) oder nicht. Wenn es sich um 
ein Set-Only-Modul handelt (eswerden 
nur bei der Initialisierung Daten an eine 
Hardware oder ein Programm überge- 
ben und das Modul danach nicht mehr 
aufgerufen) oder bei der Initialisierung 
die Routine des Moduls nichtmit aufge- 


m 
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MAUS 
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rufen werden soll, findet XControl auch 
diese Informationen innerhalb des Hea- 
ders. Dieser Header muß für jedes Mo- 
dul erzeugt werden. Von ATARI können 
eingetragene Entwickler ein Tool zur 
Erzeugung des Headers beziehen. Auf 
den Disketten zum Heft befindet sich 
ein von Uwe Hax und Oliver Scholz 
entwickelter Header-Generator. 


CPX-Programmierung 


Bei der Entwicklung eigener Module 
sollte man einige Programmierrichtli- 
nien beachten: 

- Die Module werden zusätzlich zu ei- 
nem momentan laufendem Programm 
aufgerufen; sie sollten deshalb reser- 
vierten Speicher möglichst schnell wie- 
der freigeben. Eventuell genügt ja der 
von XControl reservierte und dem Mo- 
dulals einziger nicht flüchtiger Speicher 
zur Verfügung stehende Puffer von 64 
Bytes Größe. 

- Der Aufbau und das Aussehen der 
Module sollte sich an den bereits exi- 
stierenden orientieren, damit dem Be- 
nutzer die Bedienung, durch eine ein- 
heitliche Oberfläche, leichter fällt. 

- Buttons, die zur Darstellung von Pop- 
Up-Menüs führen, sind als schattierte 
Rechtecke darzustellen. 

- Das erste Objekt eines Moduls kann 
die maximale Größe von 256 * 176 Pi- 
xeln besitzen (Arbeitsgröße von XCon- 
trol). 

- Interrupt-Vektoren dürfen nicht verän- 
dert werden. 
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- Die Buttons ‘OK’ und ‘Abbruch’/’Cancel’ sind, soweit dies 
sinnvoll ist, immer zu implementieren. 

- Die CPX-Id muß eindeutig sein, d.h. es darf keine zwei 
Module mit derselben Kennung geben (wenn Sie eine neue 
Version Ihres Moduls entwickelt haben, behalten Sie die ID 
bei und ändern die Versionsnummer. XControl aktiviert bei 
Modulen mit derselben ID jenes, welches die neueste Ver- 
sionsnummer besitzt). 

- Die erste Routine in Ihrem Modul muß die Initialisierungs- 
Routine sein (Sie können auch einen Sprungbefehl auf diese 
Routine an die erste Stelle setzen). Diese muß, unter Auswer- 
tung des bootinit-Flags, zwei Arten der Initialisierung durch- 
führen können: zum einen die Initialisierung beim Booten und 
zum anderen die eigentliche Modul-Initialisierung vor dem 
Aufruf der Hauptroutine. Der Initialisierung-Routine wird ein 
Zeiger auf die von XControl bereitgestellten Funktionen über- 
geben (siehe Bild 2; XCPB-Struktur). Dieser muß zwischen- 
gespeichert werden, da nur über diese Struktur auf die 
XControl-Routinen zugegriffen werden kann. Als Rückgabe- 
wert liefert die Initialisierungs-Routine einen Zeiger auf die 
vom Modul bereitgestellten Funktionen (siehe unten). 


XControl-Funktionen 


Bei den vom Kontrollfeld zur Verfügung gestellten Funktio- 
nen handelt es sich um Routinen zur Objektanpassung 
(rsh_...), zur Bearbeitung von Pop-Up-Menüs (Popup), zur 
einfachen Slider-Bearbeitung (SI_...), zur Formular- und Dia- 
log-Verwaltung (Xform_do,XGen_Alert, Set_Evnt_Mask, 
Get...Rect, MFsave, CPX_Save), zur Zwischenspeicherbear- 
beitung (Get_Buffer) und zur Cookie-Jar Abfrage (getcookie). 
Durch Ausnutzung dieser Routine erhält der Programmierer 
die Möglichkeit kompakte Module zu entwickeln. Besonders 
die Funktionen zur Slider- und Pop-Up-Menü-Verarbeitung 
sind sehr hilfreich. Letztere übernimmt z.B. die komplette 
Abwicklung von Pop-Ups. Sie wird nach Anwahl des Pop- 
Up-erzeugenden Buttons mit einer Liste der Menüeinträge 
aufgerufen. Sie verwalten nun vollständig die Selektion eines 
Eintrags. Bei mehr als 5 Einträgen wird der erste und letzte 
durch Pfeile ersetzt, und die Liste kann gescrollt werden. 





Modul-Funktionen 


Die Modul-Initialisierungs-Routine (siehe Tabelle 2) muß, wie 
oben bereits erwähnt, einen Zeiger auf eine Liste der modul- 
eigenen Routinen zurückliefern. Da XControl nicht bekannt 
ist, wo die einzelnen Routinen eines Moduls sich befinden 
(abgesehen von der Initialisierungs-Routine, die direkt am 
Anfang des Text-Segments stehen muß), kann es nur über 
diese Liste auf die Routine zugreifen. Dievom CPX-Modulzur 
Verfügung zu stellenden Routinen können Tabelle 3 entnom- 
men werden. Es handelt sich dabei um ‘Reaktions’-Routi- 
nen, die dann aufgerufen werden, wenn eine Operation des 
Moduls notwendig wird. Ein recht praktischer Umstand von 
XControl, der bei der Entwicklung von neuen CPX-Modulen 
wirksam wird, ist die Tatsache, daß man XControl auch als 
Programm starten kann. Dazu muß es von XCONTROL.ACC 
in XCONTROL.APP umbenannt werden. Nun können Modu- 
le ausgetestet werden, ohne jedes Mal einen Reset ausfüh- 
ren zu müssen. 
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Aufruf: 


Funktion: 


Parameter: 


Rückgabe: 


Aufruf: 
Funktion: 


Parameter: 


Rückgabe: 
Aufruf: 


Funktion: 


Parameter: 


Rückgabe: 


Aufruf: 


Funktion: 


Parameter: 


rsh_fix(num_objs, num_frst, num_frimg, 
num_tree, rs_object, rs_tedinfo, rs_string]], 
rs_iconbik, rs_bitblk, rs_frstr, rs_frimg, 
rs_trindex, rs_imdope) 

Umwandlung derKoordinatendarstellungei- 
nes Objektbaums von Zeichen- in Pixel- 
Darstellung auf der Basis von 8 * 16 Pixel 
großen Zeichen. 
num_...:.dieentsprechenden Konstanten aus 
".RSH (wird vom RCS angelegt) 

rs_...: Zeiger auf die gleichnamigen Struktu- 
ren aus *.RSH 

keine 


rsh_obfix(tree, curob) 

Umwandlung der Koordinatendarstellung ei- 
nes Objekts von Zeichen- in Pixel-Darstel- 
lung auf der Basis von 8 * 16 Pixel großen 
Zeichen [entspricht rsrc_obfix()] 

tree: Zeiger auf umzuwandelnden Objekt- 
baum 

curob: Nummer des zu konvertierenden 
Objekts 

keine 


Popuplitems[], num_items, default_item, 
font_size, button, world) 
Automatische Verwaltung eines Pop-Up-Me- 
nüs. Bei mehr als 5 Einträgen wird selbstän- 
dig gescrollt. 
items|]: Zeiger auf Liste der Menüeinträge. 
Alle Einträge müssen gleich lang sein. Au- 
Berdem sollten jedem Eintrag zwei Leerzei- 
chen voran- (für Haken) und ein Leerzeichen 
nachgestellt werden. 
num_items: Anzahl der Menüeinträge 
default_item: Nummer des vorgewählten (ab- 
gehakten) Eintrags (Zählung beginnt mit 0; 
bei -1 wird kein Eintrag vorgewählt). 
font_size: Auswahl der Zeichengröße: 

3: groß (8*16) 

5: klein (8*8) 
button: Zeiger aufRechteckstrukturGRECT) 
des Pop-Up-Menü-Buttons 
world: Zeiger auf Rechteckstruktur des CPX 
angeklickter Eintrag; -1, wenn keiner ange- 
wählt wurde 


Si_size(tree, base, slider, num_items, 
visible, direction, min_size) 

berechnet Größe des darzustellenden Sli- 
dersim Verhältnis zur GesamtzahlderListen- 
einträge 

tree: Zeiger auf Objektbaum 

base: Nummer des Slider-Hintergrund- 
objekts 

slider: Nummer des Slider-Objekts (Child 
von base) 

num_items: Gesamtanzahl derListeneinträge 


visible: Anzahl der darstellbaren Einträge 
> 
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i Fran = A FForth .. ..198.- E Befreien Sie sich von 
2 Disks mit insgesamt ca. 40 Fonts für Atari-Laserdrucker GFA-Assembler 138.- PKS-Edit „/ „ästiger & langwieriger 


Basi 3 . GEM-Programmierung. In 
GFA-Basic 3.5 228.- Script Il ma 10 ME Hen schreien 


= 7 en = GFA-Basic 3.6 278.- Signum!Drei h ie ein ei) 5 
TOS-Construction-Set DM 60. GFA-GUP/GSB 138.- Tempus Editor 118.\ Prenmmnmaches GEM- 


Veränderung der Icons und Zeichensätze des TOS Interface RCS 88.- Temp.Word 2.0 a.Anf. \ Gestaltung der GEM- 
Ve g 06 e Gans Oberfläche per Maus. 
N laxon Pascal = ies Für Turbo C & Pure C. 
PCB Edit DM 199.- Omi.Comp.3.5 218.- Datalight . j 
Platinenlayoutprogramm, auch für Bestückungspläne und \ h Aare 
Schaltpläne. Ausführliches Produktinfo anfordern! Multi GEM Sonstiges 
TOS Ext. Card 198.- XBoot 2.5 = Mega STE/ 


Scope ST DM 439.- Parse Mega STE/1 


Mega STE22 ..., 
Universelles Meßgerät. Oszillograph, Speicheroszilloskop, C-Programmierung pur ! Mega STE/2/48 . 
Voltmeter, Sampler, Funktionsgenerator. Das komplette Entwicklungssystem Mega STEI/A ... 


Mega STE/A/AB. 
Datenblatt anfordern! mit Shell, Compiler, Linker, Debugger, ! 
Assembler (68000 - 68040 und Monitor SM 144. 


P 68881/68882), umfangreiche That's a Mouse 
Meß-Kit ab DM 349.- Bibliotheken, schneller Turnaround, LOgimouse 
Meßwertaufnanme, -auswertung und Kurvenausdruck srzellente Codserzeugung,‚yoller. Harlekin li 


A = . A ANSI-Standard, Projektmanagement, Connecti CAD ......... 
Verschiedene Meßgeräte mit unterschiedlicher Ausstattung, ausgefeiltes Hilfesystem, volle } Oxyd II Buch/Disk.. 


bis zu 8 Kanäle, 4.5 Stellen (16 Bit). Unterstützung von STE und TT. Repro Studio Jun... 
Bitte fordern Sie ausführliche Infos an! nur 368.- DM Crazy Dots .. 


Kostenloser Gesamtkatalog (60 Seiten, DIN A4 )! 
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typedef struct 


direction: Richtung: 7 





0: vertikal WORD magic /* CPX-Kennung = 100 */ 
1: horizontal Pe 
min_size: minimale Pixel-Größe des Sliders Insionee, vesertaien a reserviert #) 
Rückgabe: keine unsigned resident: 1;/* Modul ist resident */ 
4 ; unsigned ; /* Boot-Initialisierung */ 
Aufruf: SI_x(tree, base, slider, value, min, max, foo) unsigned /* Set-Only-Modul */ 
SI_y(tree, base, slider, value, min, max, foo) } flage; e 
“ Een “ LONG cpx_id; /* eindeutige CPX-ID 
Funktion: Positionierung des Sliders (4 ASCII-Zeichen) */ 
Parameter: tree: Zeiger auf Objektbaum WORD cpx_version /* CPX-Versionsnummer */ 
s f Hi " char i_text[14]; /* Icon-Name */ 
base: Nummer des Slider. Hintergrundobjekts WORD sm_icon[48]; /* Icon-Bitmap (32*24 Pixel) */ 
slider: Nummer des Slider-Objekts (Child von WORD i_color; /* Icon-Farbe */ 
base) char title_text[18];/* Texte neben Icon */ 
3 Pr . ER WORD t_color: /* Textfarbe */ 
value: Beust Wert für Slider(-Position) char buffer[64]; /* nicht flüchtiger Speicher */ 
min: minimaler Wert char reserved[306]; /* reserviert */ 
max: maximaler Wert HLCEXHRAD: 





foo: Zeiger auf eine Funktion, die bei der 
Slider-Neupositionierung mit aufgerufen wird 
Rückgabe: keine 


Bild 1: Struktur des CPX-Headers 





typedef struct 











Aufruf: Si_arrow(tree, base, slider, obj, inc, min, max, fi 

value, direction, foo) WORD handle; /* von graf_handle()-Aufruf */ 

. “ n ; H rn = WORD booting; /* Boot-Initialisierung */ 

Funktion: bearbeiten die Pfeil, bzw. Hintergrundan en IE SENSE 

wahl innerhalb der Slider-Bearbeitung 
Parameter: tree: Zeiger auf Objektbaum yalıaereweryels Flreserylerene} 

= . . Le 27 ./* iert */ 

base: Nummer des Slider-Hintergrundobjekts ae Se 

slider: Nummer des Slider-Objekts (Child von /* Definition der von XContol bereitgestellten 

base) Funktionen */ 

obj:Nummer des angewählten Objekts (Pfeil, WORD eounerg eds, "alLAnderkennung #/ 

Hintergrund) } XCPB; 

> 








Bild 2: Aufbau der XCPB-Struktur 
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Rückgabe: 
Aufruf: 


Funktion: 


Parameter: 


Rückgabe: 


Aufruf: 
Funktion: 
Parameter: 


Rückgabe: 


inc: Anzahl der zu ‘blätternden’ Listenein- 
träge 
min: minimaler Wert 
max: maximaler Wert 
value: Adressen für aktuellen Wert 
direction: Richtung: 

0: vertikal 

1: horizontal 
foo: Zeiger auf eine Funktion, die bei der 
Slider-Neupositionierung mit aufgerufen wird 
keine 


SI_dragx(tree, base, slider, min, max, value, 
foo) 

SI_dragy(tree, base, slider, min, max, value, 
foo) 

Verwaltung des Verschiebens eines Sliders 
bei gedrückter Maustaste 

tree: Zeiger auf Objektbaum 

base: Nummer des Slider-Hintergrundobjekts 
slider: Nummer des Slider-Objekts (Child von 
base) 

min: minimaler Wert 

max: maximaler Wert 

value: Adressen für aktuellen Wert 

foo: Zeiger auf eine Funktion, die bei der 
Slider-Neupositionierung mit aufgerufen wird 
keine 


Xform_do(tree, startob, puntmsg) 
Formular-Verwaltung [ähnlich form_do()] 
tree: Zeiger auf zu verwaltenden Obkjekt- 
baum 

startob: Startobjekt 

Puntmsg: Zeiger auf Mitteilungspuffer 
Nummer des angeklickten Objekts; bei -1 
enthält puntmsg eine der folgenden vier Mit- 
teilungen: 

WM_REDRAW(20): Objekte, die nicht zum 
Objektbaum gehören (und deshalb nicht au- 
tomatisch neugezeichnet werden), müssen 
selbst erneuert werden [die dazu notwendige 
Rechteckliste liefern die Funktionen Get- 
FirstRect() und GetNextRect(); siehe unten] 








Aufruf: 
Funktion: 


Parameter: 


Rückgabe: 


Aufruf: 
Funktion: 


Parameter: 
Rückgabe: 


Aufruf: 
Funktion: 


Parameter: 


Rückgabe: 


Aufruf: 
Funktion: 


WM_CLOSE(22): Das Modul wurde mit OK 
beendet. 

AC_CLOSE(41): Das Modul wurde mit Ab- 
bruch beendet. 

CT_KEY(53): Die Tasten HELP, UNDO oder 
eine Funktionstaste wurden gedrückt (High- 
Byte von puntmsgl[3] enthält Scan- und Low- 
Byte ASCII-Code). 


GetFirstRect(prect) 

liefert erstes Element der Rechteckliste des 
neuzuzeichnenden Bereichs 

prect: Zeiger auf Rechteckstruktur (GRECT) 
des zu aktualisierenden Bereichs 

Zeiger auf Rechteckstruktur des zu restau- 
rierenden Bereichs; NULL: kein Bereich vor- 
handen 


GetNextRect(prect) 

liefert nächstes Element der Rechteckliste 
des neuzuzeichnenden Bereichs 

keine 

Zeiger auf Rechteckstruktur des zu restau- 
rierenden Bereichs; NULL: keine weiteren 
Bereiche vorhanden 


Set_Evnt_Mask(mask, m1, m2, time) 
bestimmt, auf welche Events ein Event-CPX 
reagieren soll 

mask: Events [wie evnt_multi()] 

m1, m2: Zeiger auf Struktur, die Mausrecht- 
eck und -richtung für Event angibt 

time: Zeit (Millisekunden) für Timer-Event 
[damit keine Programme blockiert werden 
(das GPX-Modul läuft zusätzlich zu einem 
anderen Programm (oder zum Desktop), er- 
folgt spätestens nach 30 Sekunden ein Ti- 
merevent] 

keine 


XGen_Alert(id) 

Erzeugt vordefinierte Alarmboxen; weitere 
müssen selbst erzeugt werden. [form_alert() 
ist dazu nicht sinnvoll, da damit erzeugte 


> 
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Alarmboxen bezüglich des Bildschirms und nicht der CPX-Box 
zentriert werden]. 
id: Nummer der darzustellenden Alarmbox: 

0: SAVE_DEFAULTS (Voreinstellungen sichern?) 

1: MEM_ERR (Fehler bei Speicheranforderung!) 

2: FILE_ERR (Fehler beim Schreiben/Lesen von Dateil) 

3: FILE_NOT_FOUND (Datei nicht gefunden!) 


Parameter: 


Rückgabe: 0: Abbruch wurde angewählt; sonst wurde OK angeklickt 
Aufruf: CPX_Save(ptr, num) 
Funktion: Default-Parameter werden in das DATE-Segment des aktuellen 
CPX gespeichert 
Parameter: ptr: Zeiger auf die zu speichernden Daten 
num: Byte-Anzahl der zu speichernden Daten 
Rückgabe: 0: ein Fehler ist aufgetreten; sonst: alles ok 
Aufruf: Get_Buffer() 
Funktion: ermittelt Zeiger auf einen 64 Byte großen CPXeigenen Speicher- 
bereich 
Parameter: keine 
Rückgabe: Zeiger auf Speicherbereich 
Aufruf: getcookie(cookie, p_value) 
Funktion: sucht nach gewünschtem Cookie und liefert, sofern vorhanden, 
seinen Wert 
Parameter: cookie: Cookie-ID (vier ASCII-Zeichen) 
p_value: Zeiger zur Ablage des Cookie-Wertes 
Rückgabe: 0: Cookie nicht gefunden; sonst: Cookie 
gefunden 
Aufruf: MFsave(saveit, mf) 
Funktion: Form des Mauszeigers kann zwischengespeichert und wieder 
hergestellt werden 
Parameter: saveit: bestimmt Operationsart: 
0: MFRESTORE (Mausform restaurieren) 
1: MFSAVE (Mausform zwischenspeichern) 
mf: Zeiger auf einen Speicherbereich zur Ablage der Mauszeiger- 
daten 
Rückgabe: keine 





Tabelle 1: Liste der von XControl bereitgestellten Funktionen 





Aufruf: 
Funktion: 


cpx_init(xcpb) 

Funktion muß die erste im Modul sein. Sie wird von XControl zur 
Initialisierung aufgerufen. 

Parameter: xcpb: Zeiger auf XCPB-Struktur (wird dem Modul geliefert!) 
Rückgabe: Zeiger auf die CPXINFO-Struktur, oder NULL, wenn ‘Set-Only’- 
Modul (liefert das Modul zurück!) 





Tabelle 2: Initialisierungs-Funktion der CPX-Module 





Aufruf: cpx_call(word) 

Funktion: Hauptroutine; Aufruf von XControl nach Anwahl des Moduls 

Parameter: word: Rechteckstruktur (GRECT) der Arbeitsfläche des XControl- 
Fensters 

Rückgabe: 0: Ende der Bearbeitung; sonst: CPX soll weiterbearbeitet werden 


Nachfolgende Routinen werden nur von Event-CPX benötigt: 


Aufruf: cpy_draw(clip) 

Funktion: Aufruf bei einem Redraw 

Parameter: clip: Zeiger auf Rechteckstruktur des neuzuzeichnenden Bereichs 
Rückgabe: keine > 
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NEU: XL! 128 mm 

HANDY SCANNER MIT 
NO-LIMITS + OCR- 
SOFTWARE DM 498,— 


VIDEOTEXT-DECODER 
neue Software 

"Zum Anschluß an denROM-Port. Kann mit jedem 
Videosignal betrieben werden. Läuft auf Farb- 
‚oder S/W-Minitor. Seitenweises Aufrufen — auto- 
matisches Blättern - Seiten halten - Speichern und 
Laden der empfangenen Seiten im Text- oder 
Bildschirmformat — Textausdruck-Möglichkeit 


über beliebige Drucker. 
DM 248,- 





PROFESSIONAL 
SCANNER II 


inkl. Ganzseiten-Malprogramm ROGER PAINT 
ee selbstlemende Schrifierkenmung, 300 
x.300, 300 x 600, 600x 600 DPI-Auflösung und 64 
Graustufen, diese Scannereinheit für den Industrie- 
und DTP-Bereich stellt einen absoluten Preishit 
dar. Mit ihr lassen sich sowohl Halbton als auch 
binäre Vorlagen scannen und ablegen und mit allen 
auf dem Markt befindlichen Programmen (auch 
Calamus) weiterverarbeiten. Das mitgelieferte 
Schrifterkennungsprogramm erlaubt das Umsei- 
zen von Text in ASCII-Zeichensatz und ist durch 
seine Lemfähigkeit von hoher Effizienz. 
NEU: „NO-LIMITS "SUPERSOFT FÜRST+TT 


NSTER GLEICHZEITIG / SIGNUM-FONT- 
UNTERSTÜTZUNG / IMG-TIF-STAD-MEGA 
PAINT... /POSTER PRINTING... 

Neuer Superprels/ 

Neue Software DM 1.998,- 
No-Limits Update DM 198,- 
IBM-Karte - Soft Handbuch DM 500,- 





PROFESSIONAL 
SCANNER IIl(++) 


mit No-Limits Soft Großbild OCR 
und 256 echten Grau, 2.698,- 


UPDATE HARD SOFT PROF: I auf Ill 
DIE SENSATION! DM 1.498,- 


NEU: VD-ST2001/ST + TT 

Der Nachfolger des bewährten PRO 8900 mit ent- 

scheidenden Verbesserungen: 

- NEU: 256 Grau-Modus von TT wird voll unter- 

stützt 

= NEU: frei wählbare Digitalisierbreite und -höhe " 

bis zu 1024 x 580 Pixel 

- NEU: max, 8 Bilder gleichzeitig 

- NEU: Gradationskurve veränderbar zur optima- 

len Bildanpassung 

- NEU: Abspeichern in voller Bittiefe und Auf- 

lösung im TIFF-Format 

- NEU: Histogramm-Optimierung 

-NEU: Softwarefilter wie Schärfen, Verwischen... 
- Ausdruck auf ATARI-Laser, HP-Deskjet/ 

Laserjet, NEC-P6, Epson in verschiedenen Rastern 


und Größen - bis zu 128 Grau- 
stufen pro Pixel (TBiyPixt) DM 698,- 
DM 498, 


PRO 8900 tür altest 
DM 698,- 


‚Farbversion mit RGB-Filter 


LNTEGTETET ELLE TUE N ET TE TE] 
Tel.:0049-89/34 39 16 - Fax: 0049-89/39 97 70 


CeBit ’92 
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Aufruf: 
Funktion: 
‚Parameter: 


Rückgabe: 
‚Aufruf: 
Funktion: 
Parameter: 


Rückgabe: 


Aufruf: 
Funktion: 
Parameter: 


Rückgabe: 


Aufruf: 
Funktion: 
Parameter: 


Rückgabe: 
Aufruf: 





cpx_wmove(work) 
XControl-Fenster wurde bewegt 
work: Zeiger auf Rechteckstruktur mit den 
neuen Fensterkoordinaten 
keine 
cpx_timer(event) 
Aufruf bei Timerevent 
event: Zeiger auf Ausgabewert: 
1: CPX soll verlassen werden 
keine 


cpx..key(kstate, key, event) 
‚Aufruf bei Keyboardevent 
kstate: Status der Umschalttasten 
key: gedrückte Taste (High-Byte: Scancode, 
Low-Byte: ASCII-Code) 
event: Zeiger aus Ausgabewert: 
1: CPX soll verlassen werden 
keine 


cpx_button(mrets, nclicks, event) 
Aufruf bei Maustasten-Event 
mrets: Zeiger auf Mausparameter 
nclicks: Anzahl der Maustastenklicks 
event: Zeiger aus Ausgabewert: 

1: CPX soll verlassen werden 
keine 


cpy_mi(mrets, event) 
cpy_m2(mrets, event) 















1040 STE 


MEGA STE I 
MEGA STE 1 / 
1MB SIMM 


























ATARI-HARDWARE 


748,— SCSI Wechselplatten 
1040 STE/2MB 848,— anschlußfertig, Software 


1040 STE/4MB 1098,— 


1298,— 2 TE ER Design, ext. SCSI Port 
48. 1748,- preiswert — schnell — zuverlässig 48MB, 28ms 848,- 
88,- 52 MB, 17ms 998, - 
Meciees &e_ EMULATOREN SOFTWARE SONSTIGES a ae 
. "  Monce+ 16 MHz 328,- Tempus Word 398,- ATARI Maus 48,- , 98 
Megafile 44 1398, : 425 MB, 13ms 3398, 
lasertrommel 804 398, Al Speed C16 398,- Ist Word+ 3.15 128,— That s;a’mouse 68,— 44.MB, Medium 1248,- 
"  Alonce 386 5X 578,- That's Wiite 1.45 _- 68,— ee he RR 88 MB, Medium 1498, - 
ATSpeed8MHz 248,- That’s Write2.0 + arcopı- lrackba a 
MEGA STE _ Supercharger 488. That’sPixel  248,- „NVDI 2.0 78,7 FEST & WECHSEL- 
Wir konfigurieren Ihnen indi- Kobold 68 
AA © Spectre GCR 528,- Cypfess aA 2 "PLATTEN "nackt" 
viduell jeden Mega STE mit Copro 80287 128," Signum3! Seripf2 aA. X=Boot, Remember 58,— 


; 5 A i ohne Host., ohne Gehäuse 
estplatten, Monitoren, Gra- C, 80387 5X „248, Adimens 3.1+. 78,- Hotwire, Codekeys je 78, 2 ' 
phikkarten, Emulatoren usw. BBK Fast RAM 58,— Aditalk 3.1+ 78,- Multidesk deluxe 78,— „Seagate 48 MB 328,— 





Phadhtx 1.5 358 _ Interface 88;= Quantum 52 MB 478,- 
= ® 2 Harlekin.ll 128,— Quantum 105MB  678,- 
SCANNER MONITORE Brose GA MURGEM 128, Quantum 240 MB 1478,- 
rade it Colorscan 2998,— R LDW-Power Calc2 288, 
217 EIZO 6500 . 2898,- _ ACS 168,- Quantum 425 MB 2878,— 
EPSON Gr6o00o 3198,- Top TT 21078 _ el 318,— Ode 88 SvQuestäss, ZAMBR EIS 
ogiScanman 32 468,- 17% hen 9 "_ gMAXON Pascal 198, £ c = Pı RE ee = 88MB 898. 
ogi Scanman256 848,- 17 „Millisean Coor "2198, Colamus 1.09 N ..848,— VS Eee 
incl. Repro Studio junior 4" Multiscan TT ssı 798,- _ Cranach Studio 498,- ES PSSEIEHDE i7, zum r 
14” VGA Farbe IT 648,- SC olamus.Si: 1278.= TOS 2,06 Expansions 188,— Medium 88 MB 258, — 
DRUCKER 14” MultisyneST/E 898; Outline Art 248 — TOS 2.06Extension 198,— 





NMSTE ggg, 14 ATARI SMIAA" 298, -Colamus Typeart 538, — Mighty MIC für IT 548,— FESTPLATTEN-KITS 
UEE ' " £ Portfolio 368,- SCSI Hostadapter, Kabel 
4" ATARISC1435:.588,- Avant Trace 98.- pter, 
NEC P20 688, - " : W 128 KB Memory Cord 238,— Handbuch,Software 178,— 
9" Monitor MegaSstrEa.A. 4 1 n 
EC P 30 898,— es zn Kur je Parallel Interface 188,- Gehäuse lüfierNeizteil 198,— 
EC P 60 1198,— AgAPIyFE-. ız RER g a 2 r 
HP Deskjet 500 898. GRAPHIKKARTEN  Moegapaint po” 228,- "Unsere Preise sind knallhart kalkuliert, SEI 
3 ' 7 - Alle Bestellungen werden noch am selben Tag bearbeitet. Wir ver- 
HP Deskjet Farbe azy DE es 27 Sebarve BB 2 en senden per Post oder UPS. Bestellungen, die bis 14” eingehen, 
incl. Treiber 1648,- Mega un u A Synex a an können bereits am nächsten Tag bei Ihnen eintreffen. 
HP Laserjet III 3998,— Imagine Mega olor 77 > {Fast)Alle angebotenen Artikel sind ständig ab Lager lieferbar. 
HP a IIP 2498,— anschlußfertig 398, Oxyd Il 68,— _-Telefonische Bestellungen werden Mo - Fr in der Zeit von 9* bis 19% 
HP Laserjet IIP+ 1998 - Coco, Mico, Moco“ a.A. Spacola 58,— persönlich entgegengenommen. In der übrigen Zeit ist ein Anrufbe- 


ALTERNATE Computerversand GmbH - Postfach 5906 - 6300 Gießen - Tel: 0641/76565 - Fax: 792652 


Funktion: Aufruf, wenn Mauszeiger bestimmte Recht- 
ecke verläßt oder betritt 
Parameter: mrets: Zeiger auf Mausparameter 
event: Zeiger aus Ausgabewert: 
1: GPX soll verlassen werden 
Rückgabe: keine 


Aufruf: cpx_hook(event, msg, mrets, key, nclicks) 
Funktion: Aufrufdirektnach event_multi(), bevor XCon- 

trol den Event bearbeitet 
Parameter: event: aufgetretenes Ereignis 

msg: Zeiger auf den Ereignispuffer 

mrets: Zeiger auf Mausparameter 

key: Tastendruck 

nclicks: Anzahl der Maustastenklicks 
Rückgabe: bestimmt weitere Verarbeitungsweise: 

0: Event-Verarbeitung fortsetzen 

1: Event-Verarbeitung abbrechen 


Aufruf: cpx_clos(flag) 

Funktion: wirdbeijederAC_CLOSE- und WM_CLOSE- 
Mitteilung aufgerufen; das Modul muß sofort 
eventuell reservierten Speicher freigeben 

Parameter: flag: Art der Mitteilung: 

0: AC_CLOSE 
sonst: WM_CLOSE 

Rückgabe: keine 











Tabelle 3: Liste der in CPXINFO aufgeführten Funktionen eines CPX- 
Moduls 













SCSI Festplatten 


ICD Hostadapter, Mega ST 


antworter angeschlossen. 
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Das XBRA-Verfahren 


Stellen Sie sich vor, Sie haben ein Programm geschrieben, sagen wir einen Drucker-Spooler, 
das sich resident im Speicher installiert. Um die Daten in einen Puffer übernehmen zu können 
und sie dann aus diesem an den Drucker zu schicken, mußten Sie einige Systemvektoren des 


Betriebssystems ‘verbiegen’. 


ie haben also die Adresse, auf die 
S der Vektor zeigte, ausgelesen und 

tragen die Startadresse Ihres Pro- 
gramms dort ein. Natürlich müssen Sie 
nach Beendigung Ihrer Routine zur al- 
ten Routine zurückspringen (siehe hier- 
zu ‘Timer und Interrupts’ in diesem Son- 
derheft). Dies istsicher kein großes Pro- 
blem, daSiejadie ursprüngliche Adres- 
se ausgelesen haben. 

Soweit, so gut. Solange Ihr Programm 
das einzige ist, das die entsprechenden 
Vektoren verbiegt, geht auch also gut. 
Stellen Siesich nun aber weiter vor, daß 
ein zweites Programm die gleichen Vek- 
toren verbiegen möchte. Kein Problem, 
sagen Sie? Im Prinzip haben Sie natür- 
lich recht, aber wie überprüfen Sie bitte- 
schön, ob Ihr Programm bereits instal- 
liert ist (z.B. bei einem zweiten Aufruf)? 
Und wie desaktivieren Sie Ihren Spoo- 
ler, wenn sich ein zweites Programm 
sich dazwischen geklinkt hat? 

Um diesen Problemen zu entgehen, 
wurde das XBRA-Verfahren ‘entwickelt’. 
Es wurde erstmals 1988 von Julian 
Reschke im ‘ATARI ST Profibuch’ vor- 
gestellt und hat sich mittlerweile durch- 
gesetzt. Es besteht im Grunde genom- 
men ‘nur’ daraus, eine verkettete Liste 
aufzubauen, die man komplett durch- 
laufen kann. Im Bild ist die XBRA-Struk- 
tur zu sehen. Sie wird direkt vor dem 
Anfang der neuen Routine plaziert. Sie 
bestehtaus derXBRA-Kennung ‘XBRA’, 
einer vier Buchstaben langen Routinen- 
Kennung, und dem ausgelesenen ur- 
sprünglichen Wert des Vektors. 


Mit Hilfe dieser Struktur ist es möglich, 
eine Kette von Routinen zu verfolgen. 
Dazu untersucht man die Zeiger jedes 
Systemvektors. yZeigen diese auf eine 
Routine, der dieXBRA-Struktur voraus- 
geht, nimmt man den Zeiger aus der 
XBRA-Struktur und hatsomit die Adres- 
se der nächsten Routine (siehe hierzu 
Programm im Utility-Teil). 

Sollten Sie Ihren Speicher voller 
vektor’verbiegender’ Programme ha- 
ben, kann der Fall eintreffen, daß Sie 
nicht alle Routinen einer Kette finden. 
Dann hält sich mit Sicherheit eines der 
installierten Programme nicht an das 
XBRA-Verfahren und unterbricht damit 
die ‘Durchlaufbarkeit' der Kette. 


Terminierung 


Was kann man unternehmen, wennman 
sein Programm aus einer Kette heraus- 
nehmen möchte? Wenn die Routine an 
erster Stelle der Kette steht, langt es, 
die gerettete Adresse aus xb_oldvec in 
die Systemvariable zu schreiben, die 
auf die zu terminierende Routine zeigt. 
Danachsollteman 
noch den reser- 


xb_oldvec-Variable stehende Adresse 
in die xb_oldvec-Variable ihres Vorgän- 
gers ein; das war alles. 

Beieiner unterbrochenen XBRA-Struk- 
tur wird die Sache etwas aufwendiger. 
Hier müssen Sie einen kleinen (modifi- 
zierten) Rest Ihrer XBRA-Routine ste- 
henlassen. Zum einen natürlich die 
XBRA-Struktur. Sie sollten aber die 
Routinen-Kennung (xb_id) unkenntlich 
machen (schließlich ist das folgende ja 
nicht mehr Ihre Original-Routine!). Als 
Routine benötigen Sie nun einen Pro- 
grammcode, der direkt dieinxb_oldvec 
adressierte Routine anspringt. 

Zum Schluß nach ein Wort zu der 
Routinen-Kennung. Esisteinleuchtend, 
daß ein und dieselbe Kennung für zwei 
verschiedene Routinen nicht sehr 
hilfreich ist [wie kann ein Programm 
dann (einfach) feststellen, ob es bereits 
installiert ist?]. Zu diesem Zweck wird 
von Julian Reschke eine XBRA-Liste 
geführt. Nähere Auskünfte erhalten Sie 
bei ihm (siehe ATARI Profibuch ST- 
STE-TT). 





typdef struct 
ii 


vierten Speicher 
freigeben und das 
Programm been- 
den. Eine Routine 
mitten aus einer 
XBRA-Struktur zu 
nehmen, ist auch 
kein Problem: Sie 


char 


char 


long 


} XBRA; 


xb_magic[4]; 

/* muß XBRA-Kennung enthalten: 

xb_iäl4]; 

/* vier (ASCII-)Zeichen zur Kennung der 
Routine */ 

xb_oldvec; 

/* vorheriger Wert des Vektors */ 


’XBRA' %/ 





tragen die in Ihrer XBRA-Struktur in C 
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Das 
Cookie- 
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Jar-Prinzip 


Neben dem mittlerweile etablierten XBRA-Protokoll, das wir Ihnen im vorherigen Artikel 
vorgestellt haben, existiert seit TOS 1.6 (STE) der Gookie-Jar (die Keksdose). Dabei handelt es 
sich um eine Informationsstruktur. Mit ihrer Hilfe kann man verschiedene rechnerabhängige 
Informationen erhalten bzw. Informationen mit anderen Programmen austauschen. 


Rolf Kotzian / tw 


er Cookie-Jar befindet sich ir- 
D gendwo im Speicher des Rech- 

ners. Aufseine Startadresse zeigt 
die Systemvariable _p_cookies (Adres- 
se: $5A0). Die einzelnen Kekse (Coo- 
kies) bestehen aus zwei 32-Bit-Werten 
(Im ATARI-Slang ist Cookie ein ge- 
bräuchlicher Terminus für eine 32 Bits 
große Codenummer). Der erste Wert 
stellt die Cookie-Kennung (cookie_id; 
siehe Bild 1) dar. Der zweite Wert ist 
abhängig vom jeweiligen Cookie (siehe 
Tabelle 1). 

Da der Cookie-Jar erst ab TOS 1.6 
vom Betriebssystem automatisch in- 
stalliert (und beim Reset wieder ge- 
löscht) wird, muß er bei früheren Versio- 
nen von einem residenten Programm 
installiert werden. 


Die Theorie 


Wenn man mit Cookies arbeiten will, 
muß man als erstes einmal nachsehen, 
ob es sie überhaupt gibt. Steht in der 
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Systemvariablen_p_cookies ein NULL- 
Zeiger, bedeutet dies, daß (noch) kein 
Cookie-Jar installiert ist. Hatman einen 
Zeiger bekommen, kann man die Ta- 
belle gezielt nach einem Cookie durch- 
suchen, um entsprechende Informatio- 
nen zu erhalten, einen neuen Cookie 
einzutragen oder einen Eintrag zu lö- 
schen. 

Sie fragen sich, was für einen Sinn 
solch eine Tabelle hat? Nun, zum einen 
erhält man einige wichtige Informatio- 
nen über die Rechnerkonfiguration (sie- 
henochmal Tabelle 1), undzum zweiten 
kann man anderen Programmen mittei- 
len, ob ein bestimmtes Programm in- 
stalliert ist. Dazu sollte, wie beim XBRA- 
Verfahren, dieCookie-IDindividuellsein. 
Bei der Namensgebung sind drei Punk- 
te zu beachten: 


1. Die Kennung darf nicht mit ‘_' begin- 
nen; dies hat sich ATARI für eigene 
Cookies reserviert. 


2. Die vier Zeichen müssen ASCII-Zei- 
chen (Code zwischen 32 und 126; keine 
Sonderzeichen) sein. 


3. Die Kennung sollte eine Abkürzung 
ergeben, mit deren Hilfe man auf das 
Programm schließen kann. 


Wie bereits beiderXBRA-Bezeichnung, 
wird auch beim Cookie-Jar von Julian 
Reschke eine Liste der bereits verwen- 
deten IDs geführt. 

Im Langwort cookie_value kann eine 
beliebige Information abgelegt werden, 
z.B. ein Zeiger auf eine interne Pro- 
grammstruktur [über die andere Pro- 
gramme beispielsweise bestimmte Be- 
triebsparameter verstellen können (dies 
ist beim Mausbeschleuniger MACCEL3 
der Fall), auf einen Text oder sonst 
etwas; der Phantasie sind hier keine 
Grenzen gesetzt! 

Es versteht sich natürlich von selbst, 
daß die Bedeutung von cookie_value 
irgendwo dokumentiert seinsollte! (Was 
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nütztschon ein Eintrag, wenn man nicht 
weiß, wozu er zu gebrauchen ist?) 

Die Aufmerksamen unter Ihnen wer- 
den jetzt wahrscheinlich fragen, wievie- 
le Cookies denn eigentlich in den Jar 
hineinpassen? Diese Frage kann nicht 
pauschal beantwortet werden, da der 
Speicherbereich, auf den _p_cookies 
verweist, jaan beliebiger Stelle im Spei- 
cher steht und somit irgendwann mit- 
tels Malloc (oder einer ähnlichen Funk- 
tion) angefordert wurde - die Größe des 
Jars ist also variabel! 

Um aber trotzdem das Ende der 
Tabelle erkennen zu können, existiert 
ein sogenannter NULL-Cookie (ID: 
$00000000), der als Wert die maximale 
Anzahl der in den Jar heinpassenden 


Cookies enthält. Außerdem ist er der 
letzte der aktuellen Cookie-Liste. 


Die Praxis 


Soweit die Theorie. Schauen wir uns 
einige Beispiele an, die die Nützlichkeit 
dieses Verfahrens noch einmal unter- 
streichen sollen. Besonders wichtig (im 
Hinblick auf portable Programmierung) 
ist es z.B., festzustellen, ob ein be- 
stimmtes Programm auf einem norma- 
len ST, einem getuneten Rechner (etwa 
mit einem 68020-Prozessor) oder gar 
auf dem TT läuft. Dank der vom BIOS 
installierten System-Cookies [erst ab 
TOS 1.6; vorher muß selbst installiert 
werden (siehe Programm auf der Dis- 





Rückgabewert: keiner 


Aufruf: create_cookie(cookie, id, value) 
Funktion: initialisiert einen Cookie 
Parameter: cookie: Zeiger auf COOKIE-Struktur 


id: (ASCII-)Kennzeichnung des Cookies (vier Zeichen) 
value: Wert des Cookies 


Formularausuertung 
Q\ Tabellenkalkulation 
Q\ Buchhaltung 
QL_Kassensysteme 
O, Datenbanken 








Vermessung und Planimetrie (I 
Freihandzeichnen () 


Desktop Publishing C) 


Digitalisieren C) 
CAD/CAN 


Programmsteverung G 


Aufruf: new_cookie (entry) 
Funktion: trägt neuen Cookie in den Jar ein _ Eventrecorder Ö 
Parameter: entry: Zeiger auf einzutragenden Cookie für Mausbeuegungen 


Rückgabewert: TRUE, wenn ok; FALSE im Fehlerfall und Tastatureingaben 


Aufruf: get_cookie(id, value) 








Funktion: liefert den Wert eines Cookies bis 5000 Makros 
Parameter: id: (ASCII-)Kennzeichnung des Cookies (vier Zeichen) Befehle Q 
value: Zeiger für Wert des Cookies Zahlen CO 
Rückgabewert: TRUE, wenn ok; FALSE, wenn Cookie nicht existiert Grafik Q 
Aufruf: remove_cookielid) RR 
Funktion: entfernt einen Cookie — 
Parameter: id: (ASCII-)Kennzeichnung des Cookies (vier Zeichen) Makroabläufe 


Rückgabewert: TRUE, wenn ok; FALSE, wenn Cookie nicht existiert CD variabler Geschuindigkeit 


Aufruf: move_cookiejar(dest, size) CO beliebiger Länge 
Funktion: verschiebt kompletten Jar an neue Speicherstelle; evtl. Ver- 

größerung der Anzahl der möglichen Einträge q = fi 
Parameter: dest: neue Adresse für Jar Programmiesschnittstelle 


C> Maßstabsdefinition 
C> DOS-Unterstützung 
C) Speziallösungen auf Anfrage 


size: neue Größe des Jars 
Rückgabewert: keiner 





AuRun Se SE O Digitzer-Formate bis AU 
Funktion: liefert die Anzahl der maximal möglichen Einträge in den 

installierten Jar Q 
Parameter: keine 


Informations-Material und 
telephonische Beratung bei: 


tritec & tools 


Geschuister-Scholl-Straße 5 
1080 Berlin-Mitte 
Tel./Fax.: (00372)-208 13 29 


Rückgabewert: Anzahl der maximal möglichen Cookies 


Aufruf: print_size() 
Funktion: gibt Inhalt des Jars aus Standardausgabe aus 
Parameter: keine 


Rückgabewert: keiner 
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kette)] ist es nun kein Problem mehr, festzustellen, auf 
welchem Rechner-Typ und mit welchem Prozessor das 
Programm läuft. 

Aufgrund der außerordentlichen Nützlichkeit dieses Ver- 
fahrens bot es sich an, einige Hilfsroutinen zu schreiben, die 
den Umgang mit Cookies erleichtern sollen. Diese finden Sie, 
neben einem Beispiel, auf den Disketten zum Heft. Das 
Beispiel demonstriert einen Anwendungsfall von Cookies: 
Wie kann ein Programm feststellen, ob es sich bereits instal- 
liert hat? Einige der im Listing verwendeten Funktionen 
stammen aus dem Cookie-Modul; in der Praxis dürfte es sich 
als nützlich erweisen, dieses Modul getrennt zu übersetzen 
und in einer ‘LIB’-Datei festzuhalten. Bei einer Programment- 
wicklung wird dann diese Datei automatisch vom Projektma- 
nager an den Linker weitergereicht ... 


Die Implementierung 


Kommen wir aber zu den eigentlichen Hilfroutinen des Mo- 
duls. Sie übernehmen die wichtigsten Operationen, die beim 
Umgang mit Cookies auftreten können (Erzeugen, Eintragen, 
Abfragen, Löschen etc.). 

Ein neuer Cookie kann ganz einfach mit Hilfe der Funktion 
create_cookie() erstellt werden; man übergibt dieser dazu 
lediglich einen Zeiger auf eine COOKIE-Struktur, die Pro- 
grammmkennung (cookie_id) sowie den Wert des Cookies 
(long!). Der so erzeugte Cookie kann mittels new_cookie in 
den hoffentlich vorhandenen Cookie-Jar eingetragen wer- 
den. 

Mit Hilfe von get_cookie() kann überprüft werden, ob ein 
bestimmter Cookie breits im System vorhanden ist (Return- 
Wert = TRUE); in diesem Fall wird auch gleich der zugehörige 
Wert in der Variablen value mitgeliefert. 

Das Löschen von Cookies (das kann beispielsweise dann 
notwendig sein, wenn das Programm, das diesen installiert 
hat, sich wieder aus dem Speicher entfernen will) übernimmt 
die Funktion renove_cookie(). Gelöscht wird übrigens ein- 
fach dadurch, daß - nachdem die Cookie-ID gefunden wur- 
de, alle folgenden Cookies (einschließlich des abschließen- 
den NULL-Cookies) eine Position nach oben verrückt wer- 
den. 

move_cookiejar() ermöglicht es, den kompletten Jaran eine 
neue Speicherstelle zu kopieren (der zweite Parameter gibt 
dabei die evtl. neue Größe des Jars an), und cookie_size() 
iefert die Größe des Jars, d.h. die Anzahl der maximal in ihn 
hineinpassenden Cookies. Zu guter Letzt kann der Inhalt des 
gesamten Cookie Jars noch mittels print_cookie() auf die 
Standardausgabeeinheit ausgegeben werden. 





{ 


typedef struct 
char 


cookie_id[4]; 


4 ASCII-Zeichen */ 
long cookie_value; /* Wert des Cookies */ 
} COOKIE; 


Bild 1: Die Cookie-Struktur in C 


/* Cookie-Kennung - 
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Bedeutung 


Prozessortyp: Die Werte 0, 10, 20, 30 und 40 stehen für 
die Prozessoren 68000, 68010, 68020, 68030 und 68040. 


FPU-Typ: das obere Wort gibt Auskunft über das Vorhan- 
densein eines Floating-Point-Koprozessors und über die 
Unterstützungsart des Betriebssystems bei Fließkom- 
mazahlenrechnung: 
Bit 0: gesetzt wenn FPU-Zusatzkarte (z.B. SFP 004 von 
ATARI) vorhanden ist; 68881 als Peripheriebaustein (ST 
und STE) 
Bit 1 + 2: Koprozessortyp (68881 oder 68882): 

0: weder noch 

1: 68881 oder 68882 (Typ unbekannt) 

2: 68881 

3: 68882 
Bit 3: gesetzt wenn 68040 


Fast-RAM-Buffer (TT): Zeiger auf einen 64-KByte-Puffer 
im ST-RAM, der als Zwischenspeicher beim normalen 
ACSI-DMA-Transfer dient. 


Maschinentyp; das obere Wort bezeichnet die 
Rechnerfamilie 

0: ST (520ST, 1040ST oder Mega ST) 

1: STE (1040 STE und Mega STE) 

PESRE 


Soundhardware: 

Bit 0 gesetzt, wenn ‘normaler’ Soundchip 
(Gl/Yamaha) vorhanden 

Bit 1 gesetzt, wenn Stereo-DMA-Chip vorhanden 
(STE und TT) 


DIP-Switch: Werte des internen DIP-Schalters, sofern 
vorhanden 


Video-Hardware: Das obere Wort beschreibt die Art der 
Video-Hardware: 


Außer den bisher aufgeführten Cookies, die ab TOS1.6 
automatisch installiert werden, verwendet ATARI folgende 
weitere Cookies: 


_FDC Informationen über Floppy-Controller. Oberstes Byte 
erteilt Auskunft über die maximale Schreibdichte: 
0: normal (720 KB) 
1: High-Density (1,44 MB) 
2: Extra High Density (2,88 MB) 
Die unteren drei Bytes sind eine Herstellerkennung. 


GEMDOS verfügt über FILE-LOCKING-Erweiterungen; 
Wert ist Versionsnummer der Erweiterung 


STEFIX (Patch-Programm für TOS 1.06) ist installiert 


GEMDOS-Netzwerkerweiterung; Wert ist ein Zeiger auf 
die Herstellerkennung und -versionsnummer 


POOLFIX3 (Patch-Programm für GEMDOS 0.15) ist 
installiert 


Diablo-Treiber für SLM-Laserdrucker ist installiert 





Tabelle 1: Die System-Cookies 
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Unterschiede in 
Rechner- & TOS-Versionen 


In diesem Artikel erfahren Sie, was Sie 
beachten müssen, damit Ihre Pro- 
gramme aufallen Rechnertypen (ST, 
STE und TT) und unter allen Betriebs- 
systemversionen lauffähigsind; Sie also 
‘sauber’ auf ATARI-Rechnern programmieren. 


Jürgen Haage 


elbst ein Anwender, der die ST- 
S Entwicklung seit 1985 mitverfolgt 

hat, wird die Änderungen und 
Neuerungen, die das ATARI-Betriebs- 
system erfahren hat, bis auf die größte 
Neuerung, das Desktop (STE 2.05, TT 
3.01), nicht sehr umfangreich nen- 
nen.Auch das Desktop des ST wurde 
bereits durch Zusatzprogramme wie 
Neodesk oder das Shareware-Produkt 
Gemini in den bebotenen Möglichkei- 
ten erweitert, die auch deshalb von vie- 
len weiterhin verwendet werden. Die 
Software-Entwickler brachten auf allen 
Gebieten sehrinteressante und brauch- 
bare Produkte zustande. Doch eines 
war fast bei jeder Entwicklung mehr 
oder weniger stark zu beobachten: Al- 
les wurde weniger auf Einheitlichkeit 
ausgelegt als auf Ablaufgeschwindig- 
keit. Am deutlichsten ist dies auch heu- 
te noch bei Editor- und Textverarbei- 
tungsprogrammen zu spüren. Wer erin- 
nertsich nichtan den sagenhaft schnel- 
len Tempus-Editor und kurz danach an 
sein um ein Vielfaches an Scroll-Ge- 
schwindigkeit gesteigertes Upgrade? 
Doch wie konnten solche Geschwin- 
digkeiten erreicht werden? Waren doch 






die Urvorbilder wie 1ST_WORD wahre 
Krücken in puncto Text-Scrolling. 
Warum die Betriebssystemfunktionen 
nutzen, wenn man es selbst viel besser 
nachprogrammieren kann? So dachten 
und handelten viele Programmentwick- 
ler damals und einige auch noch heute. 
Sehr zum Ärgernis der Hersteller von 
Hardware-Erweiterungen wie beispiels- 
weise von Grafikkarten und Turbo- 
boards, die die Inkompatibilitäten, zum 
Teil auch des Betriebssystemes selbst, 
am deutlichsten zu spüren bekamen. 


Das Zauberwort 
ist LINEA 


Es handelt sich dabei um eine Samm- 
lung von hardwarespezifischen Grafik- 
funktionen, auf die die VDI-Betriebssy- 
stemfunktionen zurückgreifen. Direkt 
nach der offiziellen Dokumentation von 
ATARI wurden sehr viele Programme 
dahingehend umgestellt oder neupro- 
grammiert. Heute weiß man, daß es 
besser gewesen wäre, wenn ATARI 
stattdessen offizielle Programmierricht- 
linien veröffentlicht hätte, was übrigens 


bis heute nicht geschehen ist. Mit der 
Einführung der ATARI-TT-Geräte ver- 
schwanden auch die LINEA-Funktio- 
nen. Es handelte sich eben nicht, wie 
beim VDI-Gerätetreiber, um eine gerä- 
teunabhängige Funktionssammlung. 
Auch ATARI hat den Fehler eingestan- 
den und rät nun jedem Software-Ent- 
wicklerm tunlichst die Finger von den 
hardwarespezifischen Betriebssystem- 
routinen zu lassen. Nachzulesen ist dies 
in der allerneusten Ausgabe des ATARI 
Profibuches für den ST-STE-TT vom 
Sybex Verlag. Dort sind nun auch zum 
ersten Mal die XBIOS-Funktionen, die 
die Video-Hardware betreffen, als nur 
auf die Rechnergrundkonfiguration 
(ohne Grafikzusatz-Hardware) bezoge- 
ne Funktionen deklariert. Für die Pro- 
grammierer bedeutet dies, daß sie zwar 
wissen dürfen, was die Funktionen be- 
wirken, aber der Einsatz in eigenen Pro- 
grammen eine Inkompatibilitätgarantie 
auf ATARI-Computern mit geänderten 
Grafiksystemen darstellt. 

Weitere Schwierigkeiten bereitet der 
Motorola-68030-Prozessor im TT oder 
auf Turboboard für Programme, die ei- 
nen eigenen Exceptionhandler installie- 
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ren und die Prozessoränderung nicht beachten. Die im fol- 
genden aufgeführten Punkte sollten unbedingt vor der Ent- 
wicklung systemunabhängiger Software bedacht werden. 
Die danach beschriebenen Problemlösungen bieten wir Ih- 
nen als Alternative an. 


- Hat man vor, residente Programme zu schreiben, die 
einzelne Betriebssystemfunktionen abfangen oder die Funk- 
tionsliste erweitern, sollte unbedingt der eingesetzte Prozes- 
sortyp abgefragt werden. Bei Mißachtung erhält man sonst 
fehlerhafte Parameter vom Stack- und was viel schlimmer ist, 
durch fehlerhafte Stack-Korrektur einen Bombenhagel. 

- Wird der Floating-Point-Coprozessor angesprochen, sollte 
von dessen Existenz natürlich nicht allgemein ausgegangen 
werden. Prüfen Sie sein Vorhandensein vor seinem Einsatz 
nach! 

- Gehen Sie nie von einer festen Bildschirmauflösung und 
Farbanzahl aus. Bereits beim Programmstart erhält man alle 
nötigen Informationen, umsich eindeutig auf die vorgefunde- 
ne Umgebung einzustellen. 

- Wenn Sie in GFA-BASIC programmieren sollten keine 
Befehle zum Löschen oder zum Retten und Restaurieren des 
Bildschirms benutzt werden. Es handelt sich hierbei um 
starre Befehle, die sich nicht auf das jeweils eingesetzte 
Grafiksystem einstellen können. 

- Sollten Sie in Ihren Programmen die Adresse des Bild- 
schirmspeichers ermitteln, überdenken Sie bitte, wozu Sie 
diese benötigen. Auf erweiterten Grafiksystemen ist der 
Speicherbereich meist sehr eng begrenzt und kann nicht, wie 
auf der normalen Grundkonfiguration, irgendwo im Speicher 
liegen. Des weiteren läßt sich die Art der Bitmap-Aufteilung 
nicht genau bestimmen. Ein aktuelles und gutes Beispiel, wie 
man es nicht machen sollte, ist SIGNUM! 3. Das Programm 
funktioniert zwar in Farbe auf einem normalen TT, aber bei 
Grafikkarten mit linear angeordnetem Bitmap-Speicher ver- 
sagt es seinen Dienst, da alle Bildschirmausgaben nicht über 
das Betriebssystem stattfinden. 

- Benutzen Sie nie die Funktion Setscreen (XBIOS 5) zum 
Umschalten der Bildschirmanzeige. Farbgrafikkarten haben 
meist einen eigenen Grafikspeicher, so daß auf solchen 
Systemen kompliziert aus dem ST-Speicher in den Grafik- 
speicher kopiert werden muß. Oft als ist beihochauflösender 
Farbdarstellung die Speicheranforderung so hoch, daß das 
zuvor angezeigte Bild dadurch verlorengeht. 

- Beim Anzeigen von Rastergrafiken, egal ob in Farbe oder 
Schwarzweiß, sollte dies immer mit den VDI-Funktionen 
vro_cpyfm (VDI 109) oder vrt_cpyfm (VDI 121) geschehen. 
Des weiteren ist es wichtig, die darzustellende Rastergrafik 
durch die Funktion vr_trnfm (VDI 110) in das gerätespezifi- 
sche Format zu transformieren, auch wenn es sich nur um 
eine Monochromgrafik handelt. 

- Auch die LINEA-Grafikfunktionen sind verboten. Diese sind 
nur auf ST-Computern bis Betriebssystem 2.05 vorhanden 
und speziell auf die Video-Hardware ausgelegt. 

- Rufen Sie bei Bildschirmausgaben nie die VDI-Alphatext- 
funktionen auf, da bei deren Initialisierung der Bildschirm 
komplett gelöscht wird. 

- Vermeiden Sie die direkte Ausgabe, auch mit VDI-Betriebs- 
systemfunktionen, in Bildschirmbereiche, die nicht durch ein 
AES-Fenster begrenzt sind. 
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Long stack, *cookie; 
Long bigproz = OL; 


sack = Super(0L); /* I.d.Supervisormodus schalten */ 
cookie = *((Long **)0x5A0L); /*Cookie-Zeiger holen */ 
Super((void *)sack); /* Wieder in den User-Modus */ 


if(cookie != OL) /* ist ein Cookie angelegt */ 
Y 
do 
{ 
if((cookie[0] 
t 
bigproz = cookie[1]; 


== '_CPU') && (cookie[ll] > OL)) 


/* Prozessor > 68000 */ 


break; 

ir 
cookie = &(cookie[2]); /* nächster Cookie */ 
} while( cookie[ -2]); /* war Null-Cookie? */ 


} 





Listing 1: Prozessortypermittlung an Hand des Cookie-Jar-Eintrags 








| »— Feststellen, ob 68010/20/30/40 installiert 
|: 


pea illegaltst (pc) 
move.w #4,-(sp) ; Illegal Vector 
move.w #5,-(sp) ; Setexc 
trap #BIOS 
adäq.l #8,sp 
moveg #-1,bigproz ; Ist da 
move CCR,di ; 68000 -> Illegal Instr. sonst 
ohne Effekt 
move.l d0,-(sp) ; alten Vektor wieder einsetzen 
move.w #4,-(sp) ; Illegal Vector 
move.w #5,-(sp) ; Setexc 
|  trap #BIOos 
addq.1 #8,sp 
bra weiter 
illegaltst: 
elr.w bigproz ; Illegal -> 68000 im System 
addq.l #2,2(sp) ; PC Auf nächsten Befehl setzen 
rte 











Listing 2: Prozessortypermittlung bei älteren TOS-Versionen 





; Exception-Routine: 


movea.l a7,a0 


tst.w bigproz 

beq.b 68000 ; normaler 68000 

addq.1 #8,a0 ; falls 68010 -> 68XXX 

Stackframe korrigieren 
bra.b weiter 
68000: addq.l #6,a0 
bra.b weiter 
weiter: ; jetzt können die 


Parameter korrekt vom 
; Stapel (in AO) geholt 
| werden! 





BEE 
L 





Listing 3: Beispiel zur Stackframe-Behandlung bei verschiedenen 
Prozessortypen 
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- Fenster sollten zwingend mit AES- 
Funktionen geöffnet werden und nicht 
starr auf dem Bildschirm liegen, son- 
dern verschiebbar sein. 

- Bei langeandauernden Ein-/Ausga- 
ben darf deren Dauer nie mit einem 
normalen Dialogfenster [form_alert()] 
dokumentiert werden, da hierdurch die 
Bearbeitung anderer Programme oder 
Accessories unterbunden wird (siehe 
auch ‘Multitasking’ später in diesem 
Artikel) 

- Eine Veränderung der Farbeinstellung 
sollte vor der Beendigung des Program- 
mes wieder rückgängig gemacht wer- 
den. 


Prozessortyp? 


Seit TOS 1.06 existieren die Cookie- 
Jar-Einträge. Dabei handelt es sich um 
eine Systemvariable, die auf eine Tabel- 
le mit Kennungen und Werten zeigt. 
Jeder Tabelleneintrag ist ein Paar von 
Langwörtern - ein Langwort für die ein- 
deutige Kennung des Cookies nd eines 
für den zu übermittelnden Wert. 

Will man den Prozessortyp ermitteln, 
muß man die Cookie-Jar-Systemva- 
riable auslesen und die Tabelle durch- 
suchen, bis man auf das Ende trifft, das 
durch eine Null gekennzeichnet ist. Der 
Wert der Null-Kennzeichnung ist die in 
der Cookie-Tabelle erfaßbare Anzahl 
an Einträgen. Ein Bespiel dazu finden 
Sie in Listing 1. Zur Ermittlung des Pro- 
zessortyp bei einer älteren TOS-Versi- 
on sehen Sie eine nicht ganz so einfa- 
che Methode in Listing 2. 

Zur Ermittlung wird zuerst eine Excep- 
tion-Routine illegaltst installiert, die bei 
einer illegalen Instruction aufgerufen 
werden soll. Danach wird der Befehl 
CCR ausgeführt, der erstab dem 68010 
im Befehlssatz enthalten ist. Startetman 
das Programm auf inem System mit 
einem normalen 68000-Prozessor, wird 
eine Illegal-Instruction-Exception (Aus- 
nahmebehandlung mittels Interrupt; sie- 
he Artikel ‘Timer und Interrups’ in die- 
sem Sonderheft) ausgelöst, die zuvor 
installierte Routine angesprungen und 
die Variable bigproz gelöscht. 

Was hat man nun davon, daß man den 
Prozessortyp kennt? Bei manchen Pro- 
grammierproblemen ist es wichtig, den 
Prozessor genau zu kennen. Zum Bei- 
spiel, wenn ein eigener Exception-Hand- 
ler installiert werden soll, da hierbei auf 
den um2 Byte größeren Stackframe der 


Prozessoren ab 68010 reagiert werden 
muß. (siehe Listing 3) 


Video-Hardware 


Die allergrößte Schwierigkeit war und 
ist die Beachtung und entsprechende 
Reaktion auf verschiedene Video-Hard- 
ware. Mittlerweile gibt es ein sehr reich- 
haltiges Angebot an Grafikerweiterun- 
gen und Farbgrafikkarten, die alle über 
eigene Treiber-Software verfügen, die 
speziell an die Hardware-Eigenschaf- 
ten angepaßt ist. 

Was immer noch sehr oft falsch ge- 
macht wird, ist die Ermittlung der Bild- 
schirmauflösung. Zuverlässig kann dies 
nur mit den Funktionen open_screen- 
workstation (VDI 1)odermitopen_virtual- 
screenworkstation (VDI 100) gemacht 
werden. Diese Funktionen müssen Iler- 
dings immer aufgerufen werden, wenn 
Programme die Grafikfunktionen des 
VDI-Treibers nutzen wollen. Auch bei 
BASIC-Programmen muß dies gesche- 
hen. Die Rückgabewerte in GFA-BASIC 
können aus dem vorgegebenen Array 
WORK_OUT ausgelesen werden. Listing 
4 zeigt dies in C am Beipiel einer 
open_vwork()-Routine. Die Rückgabe- 
werte, dienach dem Aufrufim work_out- 
Array stehen, können Sie der Tabelle 1 
entnehmen. 

Da diese Informationen noch lange 
nicht ausreichend sind, beispielsweise 
fehlt die Information zur Farbtiefe (Bit- 
planes), existiert die Funktion vg_extnd 
(vDI 102), mit der auch die erweiterte 
Parameterliste ermittelt werden kann 
(siehe Tabelle 2) 


GFA-BASIC 


InGFA-BASIC-Programmen lassen sich 
drei Fehler sehr häufig beobachten: 
Der Befehl BITBLT ist in der GFA- 
BASIC-Dokumentation leider sehr dürf- 
tig erklärt. Will man ihn benutzen, müs- 
sen unzählige Parameter in verschiede- 
ne Arrays eingetragen werden. Einfa- 
cher hat man es mit den Befehlen SGET 
und SPUT. Mit diesen beiden Befehlen 
istes sehr einfach möglich, den gesam- 
ten Bildschirm in einem String abzu- 
speichern und bei Bedarf wieder anzu- 
zeigen. Doch leider steht nirgens im 
Handbuch, daß sich diese Befehle nur 
auf die normalen ST-Grafikmodi be- 
schränken, daein BASIC-String nurma- 
ximal 32768 Byte aufnehmen kann, was 


Hdventures 
PS imulations 


Intocom: abaY-DM 
39,  Seastalker 29, 
39,  Zorkl 4, 
59, Hitchhikers G.1.G 49, 
49-  Infidel 49, 
39.-  Wilness 4, 
49.  Spellbreaker 39; 
49- LeatherG.o.Ph. 49, 
49. Invisicues je 19. 
IInfocom ist auch für andere Systeme lieferbar,z.B. 
MS-DOS,. ATARIXL. 064/128. 
Fordern Sie unsere speziellen Infocom Infos an. 


Level 9: Silicon Dreams (3 adv.) 29. 
Time andMagic 19,- Lancelol I 


diverse: DejaVu 19- DejaVu 2 29. 
Chronoquesi? 29. The Kristall 39, 
Cortuplion 29.- Monkey Island (engl) 59,- 


Sierra: Space Quest2 49- Gold Rush 49.- 
Conquesi of Camelot 59,- Colonels Bequesi 59.- 
Mixed Up Molher G. 49.- Manhunler SF 89. 
‚Alle anderen lieferbaren Sierra adventures 99. 
Simulations: Flight Of The Intruder 89,- 
Ulopia 89.- Lemmings 69,- Powermonger 29, 
RType2 79,- Logic 59,- Lotus Turbo 2 59,- 
Airbus 119,- Wolfpack 59,- Monkey Island 59,- 
Elvira 59, F-SSE.2 99. Railroad Tyc. 89. 
Microprose Golf 79, Silent Service 2 T9,- 
Starglider 2 (monochrom lauffähig) 29, 


Liste gratis. Versand Vorkasse 5,- Nachnahme T,- 


A+S, U.Wandrer Postf. 4 
W-3061 Lindhorst = 05725/5426 





Bürosoftware 
Neuheiten 
für ATARI ST/TT 


xtV.21 
row date von V. I 
Idschirmkas 
-ST-Fakt-Lager 


ab DM 198.00 
ab DM 348,00 


IBU 


- ST-Fibu- komplette Finanzbuch- 
it Olfener Posten- 
EB ver ab DM 388.00 
- ST-Fibu-Mini-Version ab DM 158.00 
- GMa-Text-Texiverarbeitung 
mit Serienbrieffunktion * ab DM 158,00 
- ST-Fakt-Fakturierung * ab DM 248.00 
- ST-Inven-Inventarverwaltung‘ab DM 79,00| 
- ST-Giro- Abwicklung 
des Zahlungsverkehrs auch 
für Datenträgeraustausch* ab DM 99.00) 
* Programme mit Schnittstelle zur ST-Fibu 
Demoversionen mil Handbuch je DM 60.00) 
{wird beim Kaul verrechnet) 


Kostenlose Info anfordern! 


GMa 
- 


Soft 


Gerd Matthäus 
Betriebswirt 


Bergstr. 18 - 6050 Offenbach 
Tel. 069 / 8983 45 - Fax 89 84 21 
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der monochromen Maximal-Pixel-Auflösung von 640 * 400 
entspricht.Wird ein Großbildschirm verwendet, bei dem der 
Bildschirmspeicher größer als 32 KByte angelegt ist, stürzt 
das Programm garantiert an dieser Stelle ab. 

Ein weiteres Problem stellt die Verwendung des Befehls 
CLS dar, mit dem der gesamte Bildschirminhalt gelöscht 
werden kann. Sie sollten in Ihren eigenen Programmen 
immer damit rechnen, daß weitere Programme oder Acces- 
sories ebenfalls Bildschirmausgaben machen und diese dann 
durch das Fehlverhalten Ihres Programmes übermalt wer- 
den. Öffnen Sie deshalb für jede Ausgabe ein AES-Fenster. 
Nur so ist gewährleistet, daß andere Prorgamme „parallel“ zu 
Ihrem auf dem Bildschirm ausgeben können.Auch der Aufruf 
der VDI-Funktion v_enter_cur (VDI 5, ESC 3) verursacht ein 
Löschen des gesamten Bildschirminhaltes und sollte des- 
halb nie benutzt werden. 


Warnungen 


Vermeiden Sie generell den Einsatz der XBIOS-Funktionen 
zur Ermittlung oder Beeinflussung der Video-Hardware! Im 
einzelnen sind dies die Funktionen: 





EgetPalette (XBIOS 85) 
EgetShift (XBIOS 81) 
EsetBank (XBIOS 82) 
EsetColor (XBIOS 83) 
EsetGray (XBIOS 86) 
EsetPalette (XBIOS 84) 
EsetShift (XBIOS 80) 
Esetsmear (XBIOS 87) 
Getrez (XBIOS 4) 
Logbase XBIOS 3) 
Physbase (XBIOS 2) 
Setcolor (XBIOS 7) 
Setpalette (XBIOS 6) 
Setscreen (XBIOS 33) 
Multitasking 


Bereits seit einiger Zeit existiert MultiGEM, ein GEM-Multi- 
tasking-System, das es ermöglicht, mehrere Programme 
nicht nur gleichzeitig im Speicher zu halten, sondern auch 
„parallel“ ablaufen zu lassen. Damit alles einwandfrei funktio- 
nieren kann, müssen sich die Programme strikt an die GEM- 
Konventionen halten. Einige Programmierer tun dies, aus 
Programmierzeitgründen nicht andere aus Geschwindig- 
keitsgründen. Das Betriebssystem ist nun mal nicht das 
schnellste, aber dafür geräteunabhängig (Grafiktreiber usw.). 
Damit mehrere Programme gleichzeitig ablaufen können, 
muß jedes Programm bei Text- oder Grafikausgaben ein 
AES-Fenster öffnen. Denn nur so ist gewährleistet, daß jedes 
Programm iin einen speziell angeforderten Bildschirmbereich 
ausgibt. Geschieht dies nicht, wie z.B. bei vielen Zeichenpro- 
grammen zu beobachten, ist es auch nicht möglich, diese 
Programme parallel ablaufen zu lassen. 

Ein weiterer zu beachtender Punkt ist die Gewährleistung, 
daß mehrere Programme gleichzeitig ablaufen können. Dies 
ist dann nicht der Fall, wenn eine Dialogbox auf dem Bild- 
schirm angezeigt wird, wenn man sich mit der Maus inner- 
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int work_in[12], 


work_out [57]; 


handle, 
phys_handle; 


int 


g1l_hchar, 
gl_wchar, 
gl_hbox, 
gl_wbox; 


int 


int gl_apid; 


int xres,yres; 


RR / 


/* boolean open_vwork (void); “ 
7% *P 
/* Workstation öffnen ... % 
Ir ”/ 
/* Eingabe: Nichts “ 
Lie “7 
/* Rückgabe: TRUE falls das VDI initialisiert */ 
I* werden konnte “7 
= FALSE sonst */ 


De 


boolean open_vwork (void) 
{ 
register int i; 


if((gl_apid = appl_init( )) != -1) 

{ 

for( i = 1; i < 10; work_inli++] = 1); 

/* Koordinatenangaben in Rasterkoordinaten */ 

work_in[10] = 2; 

/* das AES-Handle für VDI-Aufrufe ermitteln */ 

phys_handle = graf_handle(&gl_wchar, &gl_hchar, 
&gl_wbox, &gl_hbox); 

/* der Funktion muß ein bereits existierendes 

Handle übergeben werden */ 

work_in[0] = handle = phys_handle; 

/* Funktionsaufruf */ 

v_opnvwk( work_in, &handle, work_out); 

/* Werte werden im work_out-Array abgelegt */ 





xres = work_out[0]; /* Maximalen Pixelwerte */ 
yres = work_out[1]; 
if(handle) 


return (TRUE); 
} 


return (FALSE); 
} 


Listing 4: Beispiel zum work_out- und work_in-Feld 





halb der Menüleiste befinden, und wenn Programme (z.B. 
Mandelbrotprogramme) die ganze CPU-Zeit an sich ziehen. 
Ersteres ist sehr häufig bei Programmen zu beobachten, die 
eine Druckerausgabe erlauben und währendessen durch 
einen Dialog darauf hinweisen, daß jetzt nichtmehr weiterge- 
arbeitet werden kann. 

Nach soviel Hinweisen, Geboten und Verboten sollten Sie 
jetzt einmal Ihre eigenen Programme durchsuchen. Sie wer- 
den sicher die ein oder andere fehlerhafte Stelle finden. 


Literatur: 
ATARI Profibuch ST-STE-TT, 
Jankowski/Rabich/Reschke, SYBEX-Verlag 
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1 je Ltr: 60-- DM 





WORK_OUT( 0) - 
WORKOUT 1) - 
WORK_OUT( 2) - 


WORK_OUT( 3) - 
WORK_OUT( 4) - 
WORK_OUT(5) - 


WORK_OUT(6) - 
WORK _OUT(7) - 


WORK_OUT(8) - 
WORK_OUT(9) - 


WORK_OUT(10) - 
WORK_OUT(11) - 
WORK_OUT(12) - 
WORK_OUT(13) - 
WORK. OUT(14) - 
WORK_OUT(15) bis 
WORK_OUT(24) - 


horizontale Pixel-Anzahl 

vertikale Pixel-Anzahl 
Gerätekoordinaten-Flag 

0: Bild kann genau skaliert werden 
1: Bild kann nicht genau skaliert werden 
Breite eines Pixels in um (mm/1000) 
Höhe eines Pixels in um (mm/1000) 
Anzahl der Schriftzeichenhöhen 

0: beliebig veränderbar 

Anzahl der Linientypen 

Anzahl der Linienbreiten 

0: beliebig veränderbar 

Anzahl der Marker-Typen 

Anzahl der Marker-Größen 

0: beliebig veränderbar 

‚Anzahl der verfügbaren Zeichensätze 
Anzahl der verfügbaren Füllmuster 
Anzahl der Schraffuren 

Anzahl der vordefinierten Farben 
Anzahl der Grafikgrundfunktionen 


Liste der unterstützten Grafikgrundfunktionen. 
Das Ende ist durch -1 gekennzeichnet. 
GEM-VDI unterstützt folgende 10 Funktionen: 
1: Balken 
2: Bogen 


I 


eıckmann computer 
o-, Ihr Partner für JA ATARI Dos 


N) Acorn® im Rhein-Main-Gebiet 


® EScreen - VME - monochrom 
Grafikkarten für Großbildschirme 


@®SCSI - Festplattenlaufwerke 
ab 40 Megabyte im Minigehäuse 
oder als Einbauplatten 


@ ST/STE/TT Towersysteme 
® Portfolio Hard- und Software 


®Hardware-Utilities 
( ST Uhr II, DMATT-Switch u. a.) 


© Großes ATARI Softwareangebot 


® Eigene Fachwerkstatt mit Hard- 
und Softwareentwicklung 


In der Römerstadt 249/253 - D-W 6000 Frankfurt 90 
Telefon 069-763409 - Fax 069-7681971 : Mailbox 069-761083-8N1 


calamus® 


profi 
center 


: Kreisausschnitt 

: Kreis 

: Ellipse 

: elliptische Bogen 

: Ellipsensegment 

: Rechteck mit abgerund. Ecken 

9: ausgefülltes, abgerund. Rechteck 
10: justierter Grafiktext 

WORK_OUT(25) bis 
WORK_OUT(34) - Liste möglicher Attribute für die 
Grafikgrundfunktionen: 
0: Linie 
1: Marker 
2: Text 
3: ausgefüllter Bereich 
4: kein Attribut 
Farbdarstellungs-Flag 
0: nicht verfügbar 
1: verfügbar 
Textrotations-Flag 
0: nicht verfügbar 
1: verfügbar 
Flächenfüllung 
0: nicht verfügbar 
1: verfügbar 


WORK_OUT(35) - 


WORK_OUT(86) - 


WORK. OUT(37) - 





Tab. 1: Inhalt des work_out-Arrays auf Aufruf der Funktion OPEN WORKSTATION (VDI 1) oder OPEN VIRTUAL SCREEN WORKSTATION 


(VDI 100) 


WORK _OUT(88) - 


WORK_OUT(39) - 


WORK_OUT(40) - 


WORK_OUT(41) - 


WORK_OUT(42) - 


WORK_OUT(43) - 
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CELLARRAY-Flag 

0: nicht verfügbar 

1: verfügbar 

Anzahl der verfügbaren Farben 

0: mehr als 32768 

Kennzeichnung für Grafik-Cursor-Kontrolle 
0: keine 

1: nur Tastatur 

2: Tastatur und anderes Gerät (Maus) 
Eingabegerät für variierende Eingaben 
0: keine 

1: Tastatur 

2: anderes Gerät 

Auswahltasten 

0: keine 

1: Funktionstasten auf der Tastatur 

2: anderes Tastenfeld 
alphanumerische Eingabe (String) 

0: keine 

1: Tastatur 


WORK_OUT(44) - 


WORK_OUT(45) - 
WORK_OUT(46) - 


WORK_OUT(A7) - 
WORK_OUT(48) - 
WORK_OUT(49) - 
WORK _OUT(50) - 
WORK_OUT(S1) - 
WORK_OUT(52) - 
WORK_OUT(53) - 
WORK_OUT(54) - 
WORK_OUT(55) - 
WORK_OUT(56) - 


Ein-/Ausgabegerät-Typ 

0: nur Ausgabe 

1: nur Eingabe 

2: Ein-/Ausgabe 

3: reserviert 

4: Metafile-Ausgabe 

geringste Zeichenbreite 
geringste Zeichenhöhe ( Abstand 
zwischen Baseline und Topline) 
größte Zeichenbreite 

größte Zeichenhöhe 

geringste Linienbreite 

immer 0 

größte Linienbreite 

immer 0 

geringste Marker-Breite 
geringste Marker-Höhe 

größte Marker-Breite 

größte Marker-Höhe 





Tab. 1: Inhalt des work_out-Arrays auf Aufruf der Funktion OPEN WORKSTATION (VDI 1) oder OPEN VIRTUAL SCREEN WORKSTATION 


(VDI 100) 


WORK_OUTI( 0) - 


WORK_OUT( 1) - 


WORK_OUT(2) - 
WORK_OUT(3) - 


WORK_OUT(4) - 
WORK_OUT( 5) - 


WORK_OUT(6) - 


WORK_OUT( 7) - 


WORK_OUT(8) - 


WORK_OUTI 9) - 
WORK_OUT(10) - 


Bildschirmtyp 
0: kein Bildschirm 
1: getrennter Alpha- und Grafik- 
Kontroller und getrennte Bildschirme 
: getrennter Alpha- und Grafik- 
Kontroller mit gemeinsamem 
Bildschirm 
: gemeinsamer Alpha- und Grafik- 
Kontroller mit getrenntem Bildschirm 
: gemeinsamer Alpha- und Grafik- 
Kontroller mit gemeinsamem 
Bildschirm 
Anzahl der verfügbaren Hinter- 
grundfarben 
Bit-Vektor d.verfügbaren Texteffekte 
Flag für Vergrößerungsraster 
0: Vergrößern möglich 
1: Vergrößern nicht möglich 
Anzahl der Farbebenen 
„Lookup-table“-Unterstützung 
0: nicht verfügbar 
1: verfügbar 
Anzahl der 16*16 Pixel-Raster- 
Operationen pro Sekunde 
Contour-Fill-Verfügbarkeit 
0: nicht verfügbar 
1: verfügbar 
Textrotation 
0: nicht möglich 
1: 90°-Drehung 
2: beliebig 
Anzahl der Schreibmodi 
höchster Grad der Eingabemodi 
0: keiner 
1: request 


WORK_OUT(11) - 


WORK_OUT(12) - 


WORK_OUT(13) - 


WORK_OUT(14) - 


WORK_OUT(15) - 
WORK_OUT(16) - 
WORK_OUT(17) - 


WORK_OUT(18) - 


WORK_OUT(19) bis 
WORK_OUT(44) - 
WORK_OUT(45) - 
WORK_OUT(46) - 
WORK_OUT(47) - 
WORK_OUT(48) - 


WORK_OUT(49) bis 
WORK_OUT(SB) - 


2: sample 
Textausrichtungsverfügbarkeit 

0: nicht verfügbar 

1: verfügbar 

Farbstiftwechsel am Ausgabegerät 
0: nicht möglich 

1: möglich 
Farbbandwechselmöglichkeit 

0: nicht verfügbar 

1: farbige Zeilen 

2: farbige Zeilen und Rechtecke 
maximale Anzahl von Koordinatenpaaren 
für Polyline, Polymarker und Filled-Area 
-1: unbegrenzt 

maximale Größe des INTIN-Arrays 
-1: unbegrenzt 

Anzahl der Maustasten 
Linientypen für breite Linien 

0: nicht möglich 

1: möglich 

Schreibmodi für breite Linien 

0: nicht verfügbar 

1: verfügbar 


reserviert, enthält 0 als Ausgabewert 
obere linke x-Koordinate des 
Clipping Rechtecks 

obere linke y-Koordinate des 
Clipping Rechtecks 

untere rechte x-Koordinate des 
Clipping Rechtecks 

untere rechte y-Koordinate des 
Clipping Rechtecks 


reserviert, enthält O als Ausgabewert. 





Tab. 2: Inhalt des work_out-Arrays nach Aufruf der Funktion EXTENDED INQUIRE FUNCTION (VDI 102) 
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Kryptologie 


oder: 


Keiner versteht 


mich (hoffe ich) 





Georg Scheibler 


In diesem Artikel wollen wir 
uns mitdem Verschlüsseln von 
Daten beschäftigen. Das In- 
teresse daran, ein bestimm- 
tesWissenvorseinen Mitmen- 
schen geheimzuhalten, dürfte 
so alt sein wie die Mensch- 
heit. In der Frühgeschichte 
dürfte es sich dabei vor allem 
um das Wissen über gute 
Nahrungsplätze gehandelt ha- 
ben. 
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ie Kniffe bei der Herstellung von 
D Gebrauchsgegenständen und 

(Jagd-)Waffen wurden ebenfalls 
möglichst wenigen Leuten mitgeteilt. 
Solange das Wissen nurmündlich über- 
liefert wurde, mußte man nur den Mund 
halten, um die Verbreitung zu verhin- 
dern (manchen Leuten soll dies ja sehr 
schwerfallen). 

Wenn das Wissen schriftlich festge- 
halten wurde, mußte man dafür sorgen, 
daß die Schriftstücke nicht in die 'fal- 
schen Hände’ fielen. Zusätzliche Si- 
cherheit bietet ein Verschlüsseln des 
Textes, damit andere Leute den Inhalt 
auch dann nicht entschlüsseln können, 
wennsiein den Besitz der Schriftstücke 
kommen. 

Die Geheimhaltung interessiert vor al- 
lem die Militärs und die Geheimdienste, 
die eigentlich alles für geheim halten, 
was Ihnen in die Hände fällt, selbst 
wenn es jeder in irgendwelchen öffent- 
lichen Bibliotheken nachlesen kann. 
Andererseits lassen siesich einen Com- 
puter klauen, auf dessen Festplatte die 
Strategie für den Golfkrieg gespeichert 
war. Auf jeden Fall sind dies die beiden 
Gruppen, die besonders an guten Ver- 
schlüsselungsverfahren interessiert 
sind. Auf der anderen Seite haben Sie 
das Bedürfnis, die Chiffrierverfahren der 
Konkurrenz zu knacken. 

In der Industrie wird die Bedeutung 
von Chiffrierverfahren mit der zuneh- 
menden Verbreitung von Computern 





größer. Fast alle wichtigen Daten sind 
im Computer gespeichert. Da die Com- 
puter immer häufiger über öffentliche 
(Daten-)Netze erreichbar sind, müssen 
die Daten auch besser geschützt wer- 
den. Der erste Schritt ist sicher die Ver- 
gabe von Zugriffsrechten. Daß dieser 
Schutz nicht hundertprozentig ist, be- 
kommt man gelegentlich mit, wenn mal 
wieder bekannt wird, das Hacker ir- 
gendwo in ein System eingedrungen 
sind. Die eigentliche Gefahr stellen da- 
bei nicht so sehr die Leute dar, die nur 
zeigen wollen, daß sie in das System 
hineinkommen, sondern diejenigen, die 
an Betriebsgeheimnisse kommen wol- 
len um diese an die Konkurrenz zu ver- 
kaufen bzw. selbst zu nutzen. Damit der 
Schaden möglichst gering bleibt, kann 
man wichtigere Daten zusätzlich ver- 
schlüsseln. 

Manche versuchen auch an das Geld 
anderer Leute heranzukommen. Seit 
einigen Jahren gibt es Geldautomaten, 
bei denen man mit der EC-Karte Bar- 
geld abheben kann. Zur Identifizierung 
des Eigentümers dient dabei die ‘PIN’. 
Damit aber der Geldautomat die Rich- 
tigkeit der PIN überprüfen kann, muß 
diese auf der Karte vermerkt sein. Ein 
Dieb darf natürlich nicht mit jedem be- 
liebigen Kartenleser die Karte auslesen 
können und so an die PIN herankom- 
men, die Zahl muß also verschlüsselt 
werden. Ob das gewählte Chiffrierver- 
fahren wirklich sicher genug ist (wie 
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Banken behaupten), oder ob die Skep- 
tiker recht haben, kann ich nicht beur- 
teilen, da ich nicht weiß, welches Ver- 
fahren eingesetzt wird. Auf jeden Fall 
sind die Daten nur so lange sicher, wie 
der Codierschlüssel unbekannt ist. Bei 
einer vierstelligen Zahl kann man sonst 
schnell alle 10000 Möglichkeiten in kur- 
zer Zeit testen. 


Was heißt eigentlich 
‘verschlüsseln’? 


Unter Verschlüsseln versteht man eine 
eindeutige Substitution von Elementen 
durch andere Elemente. Dabei ist ent- 
scheidend, daß die Substitution in die 
andere Richtung ebenfalls eindeutig ist. 

Diese Definition wirkt sehr abstrakt, 
aber ich habe sie so gewählt, damit sie 
alle Möglichkeiten der Verschlüsselung 
umfaßt. So kann man die Bezeichnung 
von Gegenständen mit Namen auch als 
eine Verschlüsselung interpretieren: 

Wenn jemand sagt, er sehe einen 
Baum, dann stellt sich sein Gesprächs- 
partner auch einen Baum vor. Es ist nur 
die Frage, ob es sich dabei um einen 
Laubbaum oder einen Nadelbaum han- 
delt. Die Bezeichnung istalsonichtganz 
eindeutig. Wir haben hier aber ein Bild 
(den Anblick des Baums) durch etwas 
anderes (das Wort ‘'Baum’) ersetzt. 

Einigen Lesern mag das Hinzurech- 
nen von Sprache als Verschlüsselungs- 
verfahren zu weit gehen. Sie sollten 
aber bedenken, wie wenig sie verste- 
hen, wenn sie einen Text in einer ande- 
ren Sprache vorgelegt bekommen. Ein 
Beispiel, bei dem die Schrift regelrecht 
entschlüsselt werden mußte, sind die 
Hieroglyphen in den ägyptischen Pyra- 
miden. 


(Sp) 13,99 
13,54 

8,18 

6,26 

5,32  6D 

445 67 


63 c 
75 u 
0D (CR) 
0A (LF) 


3,80 77 
3,51 
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Bild 1: Häufigkeit der Buchstaben dieses 
Artikels 
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Wir wollen jetzt die Definition enger 
fassen. Wir betrachten nur noch Ver- 
fahren, die eingesetzt werden können, 
um Texte oder allgemein Dateien zu 
verschlüsseln. Das Ziel ist es, dafür zu 
sorgen, daß (möglichst) nur ausge- 
wählte Personen in der Lage sind, den 
Sinn des Textes oder der Datei zu ver- 
stehen. 

Die Auswahl des Verfahrens hängt von 
den Hilfsmitteln ab, die einem zur Verfü- 
gung stehen. Die Verschlüsselung ei- 
nes Textes über ein Exklusiv-Oder-Ver- 
fahren ist ohne Computer recht zeitauf- 
wendig. 


Betrachten wir ein paar 
Verfahren 


Wir wollen uns hier nur mit Verfahren 
beschäftigen, die für beliebige Texte 
geeignetsind und die von den Buchsta- 
ben bzw. deren ASCII-Wert ausgehen. 
Wir wollen nicht auf Verfahren einge- 
hen, die auf Wörter zurückgehen. (z.B. 
durch Angabe von Seiten-, Zeilen- und 
Wort-Nummer in einem abgesproche- 
nen Buch. Man muß dann nachsehen, 
welche Wörter an den entsprechenden 
Stellen stehen. Nur: Wie verschlüsselt 
man ein Wort, das in dem Buch nicht 
vorkommt?) 

Wenn wir ein Verfahren verwenden 
oder ein neues Verfahren entwerfen 
wollen, müssen wir uns immer Gedan- 
ken machen, wie ein Außenstehender 
den verschlüsselten Text entschlüsseln 
kann. Wir müssen dabei voraussetzen, 
daß ihm das Prinzip des Verfahrens 
bekannt ist. Nach einigen falschen Ver- 
suchen wird er also irgendwann auf das 
richtige Verfahren tippen. Wenn das 
Verfahren gut ist, braucht er trotzdem 
nicht den richtigen Schlüssel zu finden 
bzw. er benötigt dafür - statistisch ge- 
sehen - viel zuviel Zeit. Es kann natür- 
lich immer sein, daß jemand gleich beim 
ersten Versuch auf denrichtigen Schlüs- 
sel tippt, selbst wenn die Wahrschein- 
lichkeit für sechs Richtige im Lotto viel 
größer sein sollte. Wir müssen uns da- 
her überlegen, ob es wirklich keinen 
Ansatz gibt, mit dem der Schlüssel 
schnell ermittelt werden kann. Die 
Schwierigkeit besteht darin, daß wir für 
alle Ansätze, die uns eingefallen sind, 
zeigen können, daß der Aufwand zu 
groß wird. Wenn wir den entscheiden- 
den Ansatz übersehen, wägen wir uns 
in der falschen Gewißheit, ein sicheres 


Verfahren zu haben. Man kann dann nur 
hoffen, daß uns jemand rechtzeitig auf 
den Denkfehler aufmerksam macht. 
Daraus können Artikelserien wie [1] bis 
[4] folgen. 

Die vorgestellten Verfahren arbeiten 
mit den ASCII-Werten der Zeichen und 
liefern als Ergebnis wieder eine Folge 
von ASCII-Werten. Es dürfen dabei je- 
weils alle Werte von 0 bis 255 vorkom- 
men. Wenn man nur normalen Text ver- 
schlüsseln will, kann man eventuell die 
erlaubten Zeichen einschränken. Be- 
sonders bei den Verfahren mit Exklusiv- 
Oder-Verknüpfung kann man dadurch 
die Sicherheit des Verfahrens erhöhen. 
Darauf werde ich später noch etwas 
ausführlicher eingehen. 

Die Listings dienen nur der Illustration 
der Verfahren. Die Hauptprogramme 
enthalten daher keine Dateizugriffe. Die 
Verschlüsselungsroutinen können so 
verwendet werden, solange die Datei 
nicht länger als 32 KB ist (maximale 
String-Länge). Andernfalls müssen wir 
die Dateien in einem festen Speicher- 
bereich, oder bei GFA-BASIC 3.x in 
einem Byte-Array, ablegen. Der Zugriff 
auf die Zeichen ist dann entsprechend 
anzupassen. 

Die Listings 1 bis 4 sind sowohl für 
GFA-BASIC 2.x als auch für GFA-BA- 
SIC 3.x geeignet. Listing 5 ist nur für 
GFA-BASIC 3.x, daesin der Version 2.x 
noch keine Schiebebefehle gibt. 


Monoalphabetische 
Verfahren 


Betrachten wir zunächst einige Verfah- 
ren, die nur von dem aktuellen Zeichen 
abhängig sind. Ein bestimmtes Zeichen 
wird immer auf gleiche Zeichen abge- 
bildet. 

Ein recht einfaches Verfahren, das 
bereits Caesar verwendet hat, ver- 
schiebt die Buchstaben einfach um ein 
paar Stellen im Alphabet. Wir addieren 
zum ASCIl-Wert also einfach eine kon- 
stante Zahl dazu. Wird die Zahl dabei 
größer als die größte erlaubte Zahl, wird 
die Anzahl der Zeichen subtrahiert. 
Wenn wir z.B. jeweils 3 addieren, wird 
aus dem ‘a’($61) ein ‘d’($64) und aus 
“®($FE) wird [Pfeil hoch]($01). 

Ein weiteres Verfahren, das mit Com- 
Putern sehr einfach zu realisieren ist, ist 
die Exklusiv-Oder-Verknüpfung mit ei- 
ner beliebigen Zahl, die kleiner als 256 
ist. Wenn in Listing 1 die Zeile 22 ent- 
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fernt oder als Kommentar gekennzeichnet wird, haben wirein 
Demoprogramm für dieses Verfahren. Wird bei diesem Pro- 
gramm als Schlüssel eine Zahl größer als 255 angegeben, 
werden nur die unteren 8 Bits der Zahl verwendet. Die 
Verfahren mit Exklusiv-Oder-Verknüpfung haben den Vorteil, 
daß die gleiche Prozedur zum Entschlüsseln verwendet 
werden kann. Man muß die Verschlüsselung nur ein zweites 
Mal durchführen. 

Daesbei diesen beiden Verfahren nur 255 mögliche Schlüs- 
sel gibt, ist der Aufwand sehr klein, alle Kombinationen 
durchzuprobieren. 

Bei dem letzten Verfahren werden die Buchstaben stärker 
durcheinandergewürfelt. Da ist esschon naheliegend, gleich 
eine beliebige zufällige Vertauschungstabelle zu erstellen. 
Beim Aufstellen dieser Tabelle muß man nur darauf achten, 
daß nicht zwei Zeichen dem selben Wert zugeordnet werden. 
Es gibt für die Vertauschungstabelle [A anzahl Elemente]! 
(! = Faktultät) Möglichkeiten. Bei 256 Zeichen sind dies 
8,5*10°% Möglichkeiten. Selbst für einen schnellen Computer 
ist es unmöglich, sie alle durchzuprobieren. Haben wir jetzt 
also das sichere Verfahren? 

Um es kurz zu machen: nein. Zunächst können wir meist 
eine Aussage darüber machen, um was es sich bei der ver- 
schlüsselten Datei handelt. Inder Regel wird es sich um einen 
geschriebenen Text handeln. Bei einem normalen Text kom- 
men vor allem die normalen kleinen Buchstaben sowie die 
Satzzeichen vor. Die Großbuchstaben sind relativ selten. Es 
bleiben dann nur noch ungefähr 10% Möglichkeiten übrig. 

Beim Entschlüsseln kann man viele dieser Möglichkeiten 
ausschließen, weil die Häufigkeit der einzelnen Buchstaben 
recht unterschiedlich ist. Wenn man die statische Häufigkeit 
der Buchstaben in einer bestimmten Sprache mit der Häufig- 
keit der verschiedenen Zeichen im Text vergleicht, kann man 
schon eine ganze Reihe Buchstaben richtig zuordnen. In Bild 
1 ist der Anfang der Häufigkeitstabelle für diesen Text wie- 
dergegeben. Die Tabelle zeigt, wie unterschiedlich oft die 
einzelnen Buchstaben vorkommen. Die Anzahl der Return- 
Zeichen ($0A und $0D) hängt natürlich von der Breite der 
Zeilen ab. 

Weitere Einschränkungen sind möglich, wenn wir uns anse- 
hen, welche Buchstaben häufig als Doppelbuchstaben vor- 
kommen. Ein nächster Schritt betrachtet die Wahrscheinlich- 
keit für die Abfolge von verschieden Zeichen. z.B. ist die 
Folge ‘sch’ recht häufig, aber die Folge ‘hcs’ wird wohl kaum 
vorkommen. 

Wenn man dann erst einige Buchstaben zugeordnet hat, 
kann man die weiteren Buchstaben nach und nachraten. Wie 
gut man die Buchstaben raten kann, sieht man an den 
Rätseln, bei denen die Buchstaben durch Zahlen ersetztsind 
und als Einstieg nur ein kurzes Wort bekannt ist. 

Wird die Vertauschungstabelle mit einem Pseudozufalls- 
zahlengenerator (PSZZG) erzeugt (wie z.B. im Listing 4), 
werden von den theoretisch möglichen Kombinationen nur 
einige genutzt, da die Zufallszahl von ihrem Vorgänger ab- 
hängig ist. Die Reihenfolge der Zahlen ist eindeutig festge- 
legt, mit dem Startwert legen wir nur fest, an welcher Stelle 
der Endlosschleife wir anfangen. Die Implementation im 
Listing 4 verwendet jeweils nur die unteren acht Bits der Zahl. 
Wir erhalten dadurch immerhin mehr als 256 verschiedene 
Kombinationen. 











1: ' Verschlüsseln mit xor 
2: ' von Georg Scheibler, 4920 Lemgo 
3: ' (c) 1992 MAXON Computer 

4: a$="dies ist ein test" 

5: TEXT 0,13,a$ 

6: s1%=£&HE62FA952 

7: @crypt (s1%,a$, *b$) 

8: TEXT 0,30,b$ 

9: @crypt (s1%,b$,*c$) 

10: TEXT 0,50,c$ 

11: PROCEDURE crypt (01%, s$,d%) 

12: LOCAL d$,m%,h%,g% 

13: _' Konstanten für PSZZG 

14: ' zur schnelleren Berechnung 
15: m%=2*(23-1) !MSB 

16: h%=24(9-1) !zweites bit 
g%=m%+m%-1 !größte Zahl 

18: E 

1%=LEN (s$) 

d$=s$ !damit nicht zuviel Stringmüll entsteht 
21: FOR i%=1 TO 1% 


22: ' "AND $FF" erfolgt automatisch 
23: MID$ (d$,i%,1)=CHR$(ASC (MID$ (8$,i%,1)) XOR 01%) 
24: 01%=@pszzg (01%) 


25: NEXT i% 

26: *4%=d$ 

27: RETURN 

28: ' PSZZG mit schieben nach links 

29: DEFFN pszzg(i%)=((i%+i%) AND g%)-((0<(i% AND m%)) 
XOR ((i% AND h%)>0)) 


Listing 1: Verschlüsselung mittels XOR 


ı Verschlüsseln durch Vertauschen der Buchstaben 
2 zusätzlich xor-Verschlüsselung in Kommentarzeilen 
3 von Georg Scheibler, 4920 Lemgo 

a: (ce) 1992 MAXON Computer 

5: a$="dies ist ein test" 
6 

7 

8 


: DIM unused! (32000) 
: TEXT 0,13,a$ 
: s1%=&HE62FA952 
9: 52%=2345252 
10: @crypt (s1%, s2%, TRUE, a$,*b$) 
11: TEXT 0,30,b$ 
12: @crypt (81%, 2%, FALSE,b$,*c$) 
13: TEXT 0,50,c$ 
14: PROCEDURE crypt (key1%,key2%,crypt!,s$,d%) 
15: LOCAL d$,m%,h%, 9%, 2% 





16: ' Konstanten für PSZZG 
17: ' zur schnelleren Berechnung 
18: m%=2*(23-1) !MSB 


19: h%=2*(9-1) !zweites Bit 
20: g%=m%+m%-1 !größte Zahl 


21: 

22: 1%=LEN (s$) 
23: d$=SPACE$ (1%) 
24: i%=0 


25: max%=1% 
26: ARRAYFILL unused!(), TRUE 


27:  WHILE i%<1% 

28: keyl%=@pszzg (key1%, g%,m%,h%) 

29: Ptr%=keyl% MOD max% 

30: IF unused! (ptr%) 

1: unused! (ptr%)=FALSE 

32: ' key2%=@pszzg (key2%, g%,m%,h%) 

33: IF erypt! 

34: MID$ (d$,ptr%+1,1)=MID$ (8$,i%+1,1) 
35: ' 2%=ASC(MID$ (s$,i%+1,1)) XOR key2% 
36: * MID$ (d$,ptr%+1,1)=CHR$ (2%) 

37: ELSE 

38: MID$ (d$,i%+1,1)=MID$ (s$,ptr%+1,1) 
39: ' 2%=ASC (MID$ (s$,ptr%+1,1)) XOR key2% 
40: * MID$(d$,i%+1,1)=CHR$ (2%) 

41: ENDIF 

42: INC i% 

43: ENDIF 

44 WEND 

45 *4%=d$ 

46: RETURN 


47: DEFFN pszzg (i%,g%,m%,h%)=((i%+i%) AND 9%) -((0<(i% 
AND m%)) XOR ((i% AND h%)>0)) 





Listing 2: Verschlüsselung mittels Vertauschen der Buchstaben 
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Was ist ein Pseudozufallszahlen- 
generator (PSZZG) ? 


Da zur Erzeugung von willkürlichen Zahlenfolgen häufig ein 
PSZZG verwendet wird, wollen wir etwas ausführlicher dar- 
auf eingehen. Dafür einige Anwendungen (z.B. Monte-Carlo- 
Integration) Zufallszahlen benötigt werden, enthalten viele 
Hochsprachen eine Zufallsfunktion, mit der Zufallszahlen 
ermittelt werden können. Da die meisten Computer keinen 
echten Zufallszahlengenerator enthalten, werden die Zufalls- 
zahlen berechnet. Es sind also keine echten, sondern Pseu- 
dozufallszahlen. Charakteristisch für Pseudozufallszahlen- 
generatoren ist, daß das Ergebnis der letzten Berechnung als 
Argument für die nächste Zahl verwendet wird: 


Kun MR) 


In der Literatur findet man verschiedene Funktionsvorschrif- 
ten für die Berechnung von Zufallszahlen. Wir wollen hier nur 
die Möglichkeit betrachten, die auf rückgekoppelten Schie- 
beregistern beruht: 

Wir verwenden (oder simulieren) ein Schieberegister mit n 
Bit. Der Inhalt kann als Integerzahl entsprechender Größe 
interpretiert werden. Um eine neue Zahl zu erzeugen, werden 
die Bits um eine Stelle verschoben. Mathematisch entspricht 
dies einer Multiplikation mit zwei oder einer Division durch 
zwei. Das Bit, welches am Ende herausfällt, wird mit ein oder 
zwei Bits aus dem Innern der Zahl exklusiv-oder verknüpft 
und in die freie Stelle am anderen Ende geschoben. Wenn die 
Größe des Schieberegisters und der (die) Abgriffpunkt(e) 
günstig gesetzt werden, werden alle Zahlen zwischen O0 und 
2" erzeugt. Bei (2”-1) Aufrufen erhält man dann auch garan- 
tiert jeden Wert genau einmal geliefert. Bei der Simulation 
des Schieberegisters hat die Division den Vorteil, daß bei 


(XOR) 











Einige Werte für ‘n’ und ‘p’ 


für ein Schieberegister als PSZZG 
np np 
7 43,6 33 13 
9 45 119 8 
LORISNT, 1er 
base 151 15 
15  8,4,7,11 175 16 
17 3,5,6,11,12,14 380 47 
23 9,5,14,18 396 25 
25  3,7,18,22 476 15 
28 25,19,15,13,9,3 521 48 
31  25,24,18,13,7,6 924 31 











Bild 2: Werte für den PSZZG 
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1: ' Verschlüsseln durch Addieren der ASCII-Werte 
2: ' von Georg Scheibler, 4920 Lemgo 

3: ' (c) 1992 MAXON Computer 

4: a$="dies ist ein test" 

5: TEXT 0,13,a$ 

6: 51%=45 

7: @crypt (s1%,a$,*b$) 

8: TEXT 0,30,b$ 

9: @decrypt (s1%,b$,*c$) 

10: TEXT 0,50,c$ 

11: PROCEDURE crypt (01%, 5$,d%) 

12: LOCAL d$ 

13:  1%=LEN(s$) 

14: d$=s$ !damit nicht zuviel Stringmüll entsteht 
15:  0_1%=0 

16: FOR i%=1 TO 1% 


17: 0_0%=ASC (MID$ (5$,i%,1)) 
18: 0_1%=(0_1%+01%+0_0%) AND &HFF 
19: MID$ (d$,i%,1)=CHR$ (0_1%) 


20: NEXT i% 

21: *d%=d$ 

22: RETURN 

23: PROCEDURE decrypt (01%, s$,d%) 

24: LOCAL d$ 

25: 1%=LEN(s$) 

26: d$=s$ !damit nicht zuviel Stringmüll entsteht 
27: h1%=0 

28: FOR i%=1 TO 1% 


29: 0_1%=ASC (MID$ (8$,i%,1)) 

30: 0_0%=(o_1%-h1%-01%) AND &HFF 
31: MID$ (d$,i%,1)=CHR$ (0_0%) 

32: h1%=0_1% 


33: NEXT i% 
34:  *d%=d$ 
35: RETURN 











Listing 3: Verschlüsselung mittels Addieren der ASCII-Werte 


Integerzahlen das niedrigste Bit automatisch herausfällt. Bei 
der Multiplikation müssen wir das höchste Bit zusätzlich 
löschen. Dies kann man mit einem AND (2"-1) durchführen. 
Die Multiplikation mit 2 können wir dafür aber durch die 
schnellere Addition ersetzen. Selbst in Assembler ist die 
Addition schneller als das Verschieben um ein Bit. Werden 
sowieso nur die unteren Bit der Zahl verwendet, müssen wir 
das höchste Bit nicht einmal löschen, da bei einem Überlauf 
nur das C-Flag gesetzt wird. Es wird keine Fehlermeldung 
ausgelöst, wie dies bei Hochsprachen der Fall ist. Ein inneres 
Bit wird durch ein AND 2? geprüft. Ist das Ergebnis ungleich 
0, war das Bit gesetzt. Die Zahl ‘2r’ sollte allerdings vorher 
einer Variablen zugewiesen werden, damit sie nicht jedesmal 
berechnet werden muß (Bei GFA-BASIC 3.x können wir auch 
den Befehl ‘BTST’ verwenden). Esistzu beachten, ob die Bits 
ab 0 oder ab 1 gezählt werden. Im letzteren Fall muß p um 
Eins erniedrigt werden, es sei denn, die Zahl wird vor dem 
Test mit 2 multipliziert. 

In der Tabelle in Bild 2 sind einige Werte für ‘n’ und ‘p’ 
aufgeführt. Den ersten Wert für ‘p' habe ich von [3] übernom- 
men, die weiteren durch Ausprobieren ermittelt (der Start- 
wert des PSZZG muß das nächste Mal nach genau 2"-1 
Aufrufen als Ergebnis geliefert werden. Mir ist dabei aufgefal- 
len, daß neben dem Wert p auch immer der Wert n-p möglich 
ist. Da dies bei allen geprüften Werten für n der Fall ist, dürfte 
es sich nicht mehr um einen Zufall handeln. 

Die Bildungsvorschrift für die PSZZG auf der Basis von 
Schieberegistern bringt es mit sich, daß nach einer (beliebi- 
gen) Zahl nur zwei Zahlen möglich sind, weil n-1 Bits nur um 
eine Stelle verschoben wurden. Welche der beiden Zahlen 
gewählt wird, hängt von den inneren Abgriffen ab. 
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Wird beim Verschlüsseln eine stärkere Unterscheidung der 
Zahlen gewünscht, kann der PSZZG mehrfach hintereinan- 
der augefrufen werden. Die Anzahl der Aufrufe wird als 
Dezimation bezeichnet. Wird jede Zahl verwendet, haben wir 
eine Dezimation von 1. Wird jede zweite Zahl genommen, 
haben wir eine Dezimation von 2. Wir müssen allerdings den 
PSZZG nicht x-mal aufrufen, um eine Dezimation von x zu 
bekommen. Wir können auch den PSZZG so schreiben, daß 
direkt die Dezimation x berechnet wird, sofern x kleiner als p 
ist. Die passenden Funktionen für GFA-BASIC 3.x sind in 
Listing 5 wiedergeben. Durch die Schiebebefehle bleibt die 
Berechnung schnell. Stehen keine Schiebebefehle zur Verfü- 
gung, müssen wir stattdessen auf die Multiplikation mit bzw. 
die Division durch 2* zurückgreifen. Die Masken, die im 
Listing aus -1 erzeugt werden, erzeugt man über (2*-1). Wenn 
wir die Funktion nur für eine bestimmte Dezimation schrei- 
ben, können wir die Masken für die AND-Befehle vorgeben. 
Dies ist natürlich schneller als deren Erzeugung. 

Das Verfahren mit dem (simulierten) Schieberegister hat 
den Vorteil, daß keine Rechenungenauigkeiten auftreten 
können. Benötigen wir für die Zufallszahl mehr Bits, als die 
Integervariablen zur Verfügung stellen, verwenden wir am 
besten ein Array für die Zahl. Die Zahl wird dann auf die Array- 
Elemete aufgeteilt und der Aufwand für die Rechnung natür- 
lich größer. Eventuell kann man die Funktion in Assembler 
schreiben. 

Andere PSZZG arbeiten über die Nachkommastellen von 
Fließkommazahlen. Eine mögliche Funktion ist FRAC 
(FRAC(100000*X)+3*X) [1]. Die Eigenschaft der so erzeugten 
Zufallszahlen hängt vom Startwert ab. Würden wir z.B. mit X 
= 0.5 anfangen, wird als Folgezahl wieder 0.5 geliefert. Dies 
ist der ungünstigste Fall. Wir sehen daran aber, daß die 
Startzahl viele Stellen hinter dem Komma haben sollte. 

Bei der Verwendung von Fließkommazahlen müssen wir 
jedoch darauf achten, welches Zahlenformat die jeweilige 
Sprache bietet. So kann die gleiche Formel bei GFA-BASIC 
3.x eine andere Zahlenfolge liefern als bei GFA-BASIC 2.x, 
weil bei GFA-BASIC 3.x mit einer größeren Mantisse gerech- 
net wird. Werden dann noch Funktionen dazu genommen, 
die sowieso nur näherungsweise berechnet werden können 
(z.B. trigometrische Funktionen), ist auch noch entschei- 
dend, wie diese Funktion implementiert ist. 

Diese Überlegungen gelten auch für die von der jeweiligen 
Sprache zur Verfügung gestellte Zufallsfunktion. Diese Funk- 
tionen sind sowieso nur brauchbar, wenn man einen definier- 
ten Startwert einstellen kann. Wechseln wir die Program- 
miersprache, müssen wir zudem noch damit rechnen, daß 
der PSZZG auf einer anderen Formel basiert. 


Hauptsache gut gewickelt 


Die Spartaner im 5 Jh. v. Chr. verwendeten ein Verfahren, bei 
dem die Buchstaben nicht geändert wurden, sondern deren 
Reihenfolge. 

Sie wickelten einen Papierstreifen um einen Rundstab und 
schrieben den Text senkrecht auf den Stab. Wenn der 
Papierstreifen wieder abgewickelt wird, ist der Text nicht 
mehr zu lesen, weil die Buchstaben auseinandergerissen 
sind. Zum Entschlüsseln muß man den Papierstreifen wieder 
um einen Stab mit dem gleichen Durchmesser wickeln. Eine 
Umsetzung für den Computer sollte Ihnen nicht schwerfal- 





1: ' Verschlüsseln durch Substitution und Addieren 
2: ' von Georg Scheibler, 4920 Lemgo 

3: * (c) 1992 MAXON Computer 

4: DIM c%(256) ,d%(256) 

5: a$="dies ist ein test" 
6: TEXT 0,13,a$ 

71: z%=451 

8: 81%=23 

9: 82%=65 

10: @crypt (2%, 51%, 52%,a$, *b$) 

11: TEXT 0,30,b$ 

12: @decrypt (2%, 81%, 82%,b$, *c$) 

: TEXT 0,50,c$ 

14: PROCEDURE crypt (2%, keyl%,key2%,s$,d%) 


18r LOCAL key_1%,key_2%,1%,d$ 

16: IF 2%<>c%(256) 

17: @zufall(z%) 

18: ENDIF 

19: 1%=LEN(s$) 

20: d$=s$ !damit nicht zuviel Stringmüll entsteht 


21: key_1%=0 
22: key_2%=0 
23: FOR i%=1 TO 1% 


24: key_0%=c%(ASC (MID$ (s$,i%,1))) 

25: key_1%=c%((key_1%+keyl%+key_0%) AND &HFF) 
26: key_2%=c%((key_2%+key2%+key_1%) AND &HFF) 
27: MID$ (d$,i%, 1)=CHR$ (key_2%) 


28: NEXT i% 

29: *4%=d$ 

30: RETURN 

31: PROCEDURE decrypt (2%, keyl1%,key2%,s$,d%) 
32: LOCAL key_1%,key_2%,h1%,h2%,1%,d$ 

33: IF 2z%<>c%(256) 

34: @zufall(z%) 

35: ENDIF 

36: 1%=LEN (s$) 

37: d$=s$ !damit nicht zuviel Stringmüll entsteht 
38: h1%=0 


39: h2%=0 

40: FOR i%=1 TO 1% 

41: key_2%= (ASC (MID$ (8$,1%,1))) 

42: key_1%=(d%(key_2%)-h2%-key2%) AND &HFF 
43: key_0%= (d%(key_1%)-h1%-key1%) AND &HFF 
44: MID$ (d$,i%,1)=CHR$ (d%(key_0%)) 

45: h1%=key_1% 

46: h2%=key_2% 

47: NEXT i% 

48: *d%=d$ 

49: RETURN 


50: PROCEDURE zufall(x%) 
51: LOCAL h1%,h2%, xx% 


52: ' Erzeugen einer "zufälligen" 
53: ' vVerschlüsselungstabelle 
54: ' mit Pseudozufallzahlen 


55: _ 

56: h1%=2*11 !maske ffr bit 1 (+ obergrenze) 
57: h2%=242 !maske ffr bit 2 

58: x%=x% MOD h1% 

59: IF x%=0 

60: INC x% 

61: ENDIF 

62: ARRAYFILL c%(),-1 

63: c%(256)=x% !Schlüssel merken 

64: ent%=0 

65: WHILE cnt%<256 !Codiertabelle aufbauen 


66: xx%=x% AND &HFF 

67: IF c%(xx%)<0 !Wert noch nicht dagewesen 
68: c%(xx%)=cnt% !Codiertabelle 

69: d%(cnt%)=xx% !Decodiertabelle 

70: INC ent% 

71: ENDIF 

712% ADD x%,x% 

73: IF (x% AND h1%)<>0 XOR (x% AND h2%)<>0 
74: INC x% 

75: ENDIF 

76: IF x%=>h1% 

77: SUB x%,h1% 

78: ENDIF 

79: WEND 

80: RETURN 








Listing 4: Verschlüsselung mittels Substitution und Addition 
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len. Da das Verfahren nur wenige Schlüssel erlaubt, wollen 
wir hier auf ein Listing verzichten. 


Bäumchen wechsel’ dich 


Eine sicherere Möglichkeit ist, die Reihenfolge der Buchsta- 
ben nach einer willkürlichen Vertauschungstabelle neu zu 
sortieren. Der Text wird dabei in kleine Abschnitte mit soviel 
Buchstaben unterteilt, wie die Vertauschungstabelle an Ele- 
menten hat. Da der letzte Abschnitt meist weniger Buchsta- 
ben hat, müssen wir noch ein paar willkürliche Buchsta- 
ben anhängen. Würden wir die anderen Plätze freilassen, 
ergäben sich Anhaltspunkte auf die Vertauschungstabelle. 
Wenn wir die Vertauschungstabelle groß genug machen, 
können wir den gesamten Textals einen Abschnitt verschlüs- 
seln. 

Wenn wir den Text nicht auffüllen wollen, können wir in der 
Vertauschungstabelle die Felder löschen, die eine Position 
hinter den vorhandenen Buchstaben darstellt. Wir erstellen 
also eine neue Tabelle, die nur noch soviel Elemente enthält, 
wie auch Buchstaben vorhanden sind. Bei der Realisierung 
würde man allerdings nicht die Tabelle verändern, sondern 
einfach den Pointer in die Tabelle erhöhen, ohne einen 
Buchstaben zu kopieren. 

Damit die Ver- bzw. Entschlüsselung in einer akzeptablen 
Zeit erfolgt, müssen wir allerdings den gesamten verschlüs- 
selten Text (bzw. einen Abschnitt) auf einmal im Speicher 
halten. Im anderen Fall müssen wir viel zu viele Dateizugriffe 
vornehmen. Im Klartext greifen wir auf die Buchstaben der 
Reihe nach zu, es reicht daher, wenn wir jeweils kurze 
Abschnitte im Computer halten. Beim Atari ST sollte der 
Speicher normalerweise groß genug sein, um den gesamten 
Text auf einmal zu laden. Ist die Datei jedoch größer, oder 
wollen wir die verschlüsselte Datei jemandem zusenden, der 
nur einen Computer mit wenig Speicher hat, müssen wir die 
Verschlüsselung ebenfalls in kleinen Abschnitten durchfüh- 
ren. Wir sollten in diesem Fall beim zweiten Abschnitt den 
PSZZG einfach weiterlaufen lassen. Würden wir wieder mit 
dem ersten Startwert anfangen, wäre der Text leichter zu 
entschlüsseln. 

Wir können die Positionen der Buchstaben mit jedem 
PSZZG berechnen, der garantiert jeden möglichen Wert 
mindestens einmal pro Zyklus annimmt (z.B. den PSZZG mit 
Schieberegister). In diesem Fall ist es möglich, einen PSZZG 
zu verwenden, der mehr Zahlen liefert, als der Text lang ist. 
Man kann dann z.B. die letzten n Bit der Zahl (d.h. modulo 2°) 
als neue Position für den Buchstaben verwenden, wobeinso 
gewählt wird, das 2" gerade größer ist als die Länge des 
Textes. Diese Modulodivision kann man schnell mit AND (2”- 
1) durchführen. Eine andere Möglichkeit ist, den Wert [Zahl 
des PSZZG] modulo [Länge des Textes] zu verwenden. In 
diesem Fall müssen wir zwar direkt eine Division durchfüh- 
ren, aber dafür erscheint mir dieses Verfahren sicherer, da 
jede Zahl mehr als zwei Nachfolger haben kann (Listing 2). 

Der Text sollte dabei um einiges kleiner sein als die größte 
Zahl, die der PSZZG liefert. Von diesem Verhältnis hängt die 
Anzahl der möglichen Nachfolger ab. Beisehr langen Dateien 
sollte man entweder einen größeren PSZZG verwenden oder 
den Text abschnittweise verschlüsseln. Für die Länge der 
Abschnitte sollte man auf keinen Fall Zweierpotenzen ver- 
wenden. 
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Wenn wir zur Ermittlung der Zufallszahlen eine Dezimation 
größer Eins verwenden, müssen wir darauf achten, daß 
trotzdem alle Zahlen möglich bleiben. Dies ist gegeben, 
wenn 2'-1 (r Bit PSZZG) und die Dezimation keinen gemein- 
samen Teiler haben. 

Wenn wir nur einen Teil der Zahl des PSZZG bzw. das 
Ergebnis der Modulodivision als Pointer verwenden, müssen 
wir überprüfen, ob eine bestimmte Position schon einmal (in 
diesem Abschnitt) errechnet wurde. Dafür benötigen wir ein 
zusätzliches Array. Da wir nur zwei Zustände benötigen 
(schon dagewesen, noch nicht dagewesen) verwenden wir 
ein Boolsches Array. Wollen wir nur Text verschlüsseln, 
kommt in der Datei also der ASCII-Wert O nicht vor, können 
wir auch den Speicherbereich für den verschlüsselten Text 
dafür verwenden, indem wir vor dem Verschlüsseln den 
Bereich auf 0 setzen. Beim Entschlüsseln werden die Zei- 
chen nach der Bearbeitung gelöscht. Diese Methode hat 
zwei Vorteile: 


1) Wir sparen Platz: Das Boolsche Array benötigt 1/8 des 
Speichers des verschlüsselten Textes. 

2) Der Zugriff auf ein Byte-Array ist schneller als der Zugriff 
auf ein Boolsches Array (Bit-Array). 


Dem stehen die Nachteile gegenüber, daß der codierte Text 
dabei gelöscht wird und daß - wie bereits vorausgesetzt - 
nicht alle 256 ASCII-Zeichen in der Datei vorkommen dürfen. 

Eine Möglichkeit zum Knacken bei diesem Verfahren be- 
steht darin, ausgehend von verschiedenen Startwerten für 
den PSZZG z.B. die ersten 80 Bytes zu decodieren: Man muß 
sich dann ansehen, ob die decodierte Buchstabenfolge 
einen Sinn ergibt. Die Frage ist, ob es eine schnelle Möglich- 
keit gibt, den Computer mit der Überprüfung zu betrauen. 
Eine Möglichkeit wäre z.B., daß der Computer die erzeugten 
Wörterin einem Wörterbuch sucht und alle Versuche verwirft, 
bei denen nicht ein bestimmter Anteil als gültige Wörter 
erkannt wurde. Wenn wir uns alle decodierten Strings anse- 
hen müssen, umzu entscheiden, ob derrichtige Ansatz dabei 
ist, haben wir viel zu tun. Die Anzahl der Möglichkeiten steigt 
dabei mit der Textlänge. 

Wenn wir verhindern wollen, daß der Schlüsseldurch Deco- 
dieren der ersten Bytes erkannt wird, können wir zusätzlich 





' Funktionen zur Berechnung von Zufallszahlen 


' mit n Bit, zweiter Abgriff bei Bit p 
zählung in gleiche Richtung wie Schieben 
mit Dezimation x ; x<p 
von Georg Scheibler, 4920 Lemgo 
(ec) 1992 MAXON Computer 
FUNCTION pszzg_l(2%,n%,p%,x%) 
'‘ Schieben nach links 
9:  neu%=SHR(2%,n%-x%) XOR SHR(Z%, p%-x%) 
10: neu%=neu% AND SHR(-1,32-x%) 
11: 2%=SHL(2%,x%) AND SHR(-1,32-n%) 
12: RETURN z% OR neu% 
13: ENDFUNC 
14: FUNCTION pszzg_r(2%,n%,p%,x%) 
15: ' Schieben nach rechts 
16: neu%=z% XOR SHR(z%,n%-p%) 
17: neu%=SHL(neu% AND SHR(-1,32-x%) ‚n%-x%) 
18: Z%=SHR(Z%,x%) 
19: RETURN z% OR neu% 
20: ENDFUNC 











Listing 5: Funktionen zur Berechnung von Zufallszahlen 


einen Vorspann aus einer zufälligen 
Zeichenfolge vor den eigentlichen Text 
setzen (z.B. einen bereits verschlüssel- 
ten Text von 1KB Länge). 

Wissen (bzw. vermuten) wir, daß die 
Positionen mit einem PSZZG auf der 
Basis eines Schieberegisters ermittelt 
wurden, bei dem dann die unteren i Bit 
für die Zahl verwendet wurden, können 
wir die Tatsache ausnutzen, daß jede 
Zahl nur zwei mögliche Nachfolger hat. 
Nach der Zahl x können nur die Zahlen 
2*x und 2*’x+1 folgen (wenn mit zwei 
multipliziert wird). Nach dem ersten 
Zeichen kann nur das zweite oder das 
dritte Zeichen folgen. Dem zweiten Zei- 
chen folgt das 4. oder 5. Zeichen. Wir 
haben dann für das zweite Zeichen 4, 
für das dritte Zeichen acht mögliche 
Positionen. Nach n Zeichen sind 2" Po- 
sitionen möglich. Wir sollten aber 
nach einigen Zeichen in der Lage sein, 
uns auf wenige Folgen zu beschränken, 
weil die anderen keinen Sinn ergeben. 
Aus dem Weg, den wir jeweils einge- 
schlagen haben, können wir die weite- 
ren Bits des PSZZG ermitteln, sobald 
wir soviel Buchstaben gefunden haben, 
wie Bits am oberen Ende der Zufallszahl 
abgeschnitten wurden. Je größer der 
PSZZG ist, desto mehr Buchstaben 
müssen wir raten. Die weiteren Buch- 
staben können dann direkt berechnet 
werden. Wir müssen nur noch heraus- 
finden, an welchen Stellen im decodier- 
ten Text wir uns befinden. Zwischen- 
durch kann es dabei zu Störungen kom- 
men, wenn die Positionen schon vorher 
vergeben wurden. An einigen dieser 
Stellen müssen wir erneut anfangen, 
die Bit-Folge aufzubauen. 

Man könnte eine Dezimation von x 
verwenden. Für den ersten Nachfolger 
ergeben sich dann zwar 2* Möglichkei- 
ten, aber dafür haben wir dann bereits 
nach sehr wenigen Buchstaben soviele 
Bits festgelegt, daß die weiteren Zei- 
chen viel schneller eindeutig festgelegt 
sind. Wir müssen allerdings häufiger 
neu anfangen. Der Aufwand wird also 
schon größer. 

Berechnen wir die Position der Zei- 
chen über Modulo [Länge des Textes], 
gibt es für jede Position viele mögliche 
Nachfolger, sofern der Text nicht gera- 
de eine Länge von 2" hat. Die Anzahl 
hängt davon ab, um welchen Faktor die 
Zufallszahl größer ist als die Länge des 
Textes. Man sollte den PSZZG aller- 
dings mit einer großen Zahl starten, 
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damit die Zahl möglichst schnell einmal 
größer als die Textlänge wird. Starten 
wir den PSZZG mit 1, wirkt die Modulo- 
division erst ab dem 10. oder 15. Zei- 
chen, je nach Länge des Textes. 

Zumindest, wenn man kein zusätzli- 
ches Verfahren verwendet, sollte man 
die zweite Variante wählen. 

Kombinieren wir dieses Verfahren mit 
einem anderen, das die Buchstaben 
verändert, wird es viel schwerer, den 
Schlüssel zu finden. In diesem Fall dürf- 
te die Entscheidung für den richtigen 
Weg schwerfallen, da dieser noch kei- 
nen sinnvollen Text ergibt. 


Polyalphabetische 
Verfahren 


Bei Polyalphabetischen Verfahren wird 
der gleiche Buchstabe an verschiede- 
nen Stellen im Text durch verschiedene 


mit dem gleichen Byte verschlüsselt 
wurden, den Wert der Schlüssel-Bytes 
zu ermitteln. Im günstigsten Fall haben 
wir mehr Bytes im Schlüssel, als der 
Text Zeichen hat. Es gibt dann keine 
Wiederholung, die es ermöglicht, den 
Schlüssel zu finden. Dieses Verfahren 
wurde 1917 vonG. S. Vernam erfunden. 
Laut [1] soll dieses Verfahren für das 
‘rote Telefon’ (tatsächlich ein Fernschrei- 
ber) zwischen Washington und Moskau 
verwendet werden. 

Eine Alternative zu einem langen 
Schlüsselsind zweirelativ kurze Schlüs- 
sel mit unterschiedlicher Länge. Wenn 
wir den Text zunächst mit dem einen 
und dann mit dem anderen Schlüssel 
codieren, entspricht dieseinemSchlüs- 
sel mit einer Länge, die gleich dem 
kleinsten gemeinsamen Vielfachen der 
Längen der beiden Schlüssel ist. Die- 
sen Schlüssel kann man ermitteln, in- 





P,Q Zwei beliebige Primzahlen 
N =P*’QF =(P-1)*(Q-1) 


T beliebige Zahl mit (S*T)modF 


Verschlüsselung von Zahlen X; 
Verschlüsseln: Y=X° mod N 
Entschlüsseln: X = Y'mod N 





S _ beliebige Zahl mit S<F und ggt(F,S) =1 


nur N und S dürfen bekanntgegeben werden!! 


| 
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Bild 3: Kurzfassung des 
RSA-Algorithmus’ 
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Buchstaben ersetzt. Die Entschlüsse- 
lung wird dadurch schwieriger. 

Wir haben bereits gesehen, daß die 
Verschlüsselung über Exklusiv-Oder 
recht einfach, aber bei Verschlüsselung 
mit einem Byte das Verfahren nicht sehr 
sicher ist. Vorhin wurde gesagt, daß im 
Listing 1 eine Zeile gestrichen werden 
sollte. Dies zeigt bereits, daß im Listing 
zumindest eine Variante des Verfahrens 
verwendet wird. 


Vernam-Verfahren 


Das Verfahren wird sicherer, wenn wir 
nicht nur ein Byte, sondern eine größere 
Anzahl Bytes zum Verschlüsseln ver- 
wenden. Der erste Buchstabe wird mit 
dem ersten Byte verschlüsselt, das 
zweite Zeichen mit dem zweiten Byte 
usw. bis zum letzten Byte des Schlüs- 
sels. Danach beginnen wir wieder mit 
dem ersten Byte. 

Zum Entschlüsseln muß manzunächst 
herausfinden, wieviel Bytes der Schlüs- 
sel hat, um dann aus den Zeichen, die 


dem man die beiden Schlüssel unter- 
einander exklusiv-Oder-verknüpft. Je- 
desmal, wenn nurein Schlüsselzu Ende 
ist, beginnen wird bei diesem String 
wieder am Anfang. Wenn wir bei beiden 
Schlüsseln gleichzeitig wieder am An- 
fang anfangen müssen, beginnt der 
Schlüssel sich zu wiederholen. 

Wenn wir den Schlüssel bei der Nach- 
richtenübermittlung verwenden wollen, 
muß auch der Empfänger in dessen 
Besitz sein. Verwenden wir immer den 
gleichen Schlüssel, so kann jemand, 
der mehrere Nachrichten abfängt, ihn 
daraus irgendwann ermitteln. Man soll- 
te jeden Schlüssel also möglichst sel- 
ten (am besten nur einmal) verwenden. 

Da der Aufwand, einen langen Schlüs- 
sel zu übermitteln, recht groß wird, 
müssen wir uns ein anderes Verfahren 
überlegen: 

Wir können als Schlüssel im Prinzip 
jede Datei verwenden, die auf beiden 
Seiten (also beim Sender und Empfän- 
ger) vorhanden ist. In der Datei sollten 
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allerdings keine größeren Abschnitte 
vorkommen, die nur ein Zeichen enthal- 
ten. Man sollte es sich also gut überle- 
gen, ob ein Bild als Schlüssel geeignet 
ist. 

Sehr große Schlüssel stellen z.B. CD- 
ROM-Disks dar. Wenn beide Seiten ein 
entsprechendes Laufwerk haben, kann 
man verabreden, daß ein bestimmtes 
CD-ROM als Schlüssel dient. Der Inhalt 
spielt in diesem Zusammenhang keine 
Rolle. Man muß nur festlegen, an wel- 
cher Stelle der Schlüssel anfängt. 

Wir können uns den Schlüssel auch 
besorgen, indem wir ab einem beliebi- 
gen, definierten Zeitpunkt einen Sender 
empfangen, der digitale Daten sendet. 
Es spielt dabei keine Rolle, welche Da- 
ten dort übertragen werden. Wir müs- 
sen die Daten nur als n-Bit-Code inter- 
pretieren können. 

Eine Möglichkeit wären z.B. die Daten 
von Wettersatelliten, da das Wetter je- 
den Tag anders ist. Natürlich müssen 
Sender und Empfänger die gleichen 
Daten fehlerfreiempfangen können. Für 
den normalen Anwender wird der Auf- 
wand für eine Empfangsanlage zu groß. 
Er muß daher auf andere Verfahren zu- 
rückgreifen. 

Wir haben bereits einen PSZZG ver- 
wendet, um eine große Anzahl Zahlen 
zu ermitteln. Wir können diese Zahlen 
auch für die Exklusiv-Oder-Verschlüs- 
selung verwenden. Wenn wir beliebige 
ASCII-Dateien verschlüsseln wollen, 
verwenden wir die unteren 8 Bits der 
Zahl. Ein entsprechendes Programm 
zeigt Listing 1. 

Werden auf diese Weise normale Tex- 
te verschlüsselt, so ist dieses Verfahren 
nicht mehr sicher. Wie in [4] gezeigt 
wurde, ist es sehr einfach, den Start- 
wert des PSZZG zu ermitteln. In [4] wird 
zwar nur der PSZZG aus [3] betrachtet 
(9 Bit, Dezimation 5), aber das Verfah- 
ren ist auch bei Verschlüsselung mit 
einem anderen PSZZG auf der Basis 
von Schieberegistern anwendbar. Das 
Knacken wird allerdings schwieriger, 
wenn der PSZZG mehr Bits hat. 

Den Ansatz zum Entschlüsseln liefern 
die oberen Bits der verschlüsselten 
Zeichen. Ein normaler Textbestehtüber- 
wiegend aus Kleinbuchstaben. Die 
ASCII-Werte dafür sind $6x und $7x. In 
Binärform ist das %011xxxxx. Wenn 
wir eine Stelle finden, an der mehrere 
kleine Buchstaben hintereinander ste- 
hen, können wir bei jedem Zeichen drei 
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b= 11 = %1011 
alt -ad*a2*ral 
ax art 


a'modN =23 mod 50 =23 


a®modN =(23*23)mod50 =29 
a'modN =(29*°29)mod50 =41 
a®modN =(41*41)mod50 =31 


23'' mod 50 =(23 * 29 *31)modN=27 


Bild 4: Berechnung von ab mod N mit a= 23, 
b=11,N=50 


Bits der Zufallszahl ermitteln. Bei be- 
kannter (vermuteter) Dezimation kann 
man die ganze Zufallszahl zusammen- 
setzen. Die Anzahl der kleinen Buchsta- 
ben, die man dafür benötigt, hängt von 
der Größe des Schieberegisters ab. 
Wenn in dem untersuchten Abschnitt 
andere Zeichen vorkommen, d.h. die 
ermittelte Zahl entschlüsselt die nach- 
folgenden Zeichen nicht richtig, neh- 
men wir den Abschnitt, der ein Zeichen 
später anfängt. 

Eine Möglichkeit, die verräterischen 
Bits zu vermeiden, besteht darin, daß wir 
nicht die unteren 8 Bits der Zufallszahl 
als Schlüssel verwenden, sondern nur 
die unteren 5 Bits. In diesem Fall gibt es 
keine Anhaltspunkte für die Zufallszahl, 
aber dafür kann man erkennen, zu wel- 
cher Gruppe von 32 Zeichen das jewei- 
lige Zeichen gehört. Man erkennt also, 
ob es sich um einen Klein-, einen Groß- 
buchstaben oder ein Satzzeichen han- 
delt. Die deutschen Umlaute fallen da- 
bei besonders auf, sofern der Atari- 
(IBM-)ASCII-Code verwendet wird. 

Die schwächste Stelle bei dieser Vari- 
ante sind die Leerzeichen. Zusammen 
mit den Satzzeichen sind hier die obe- 











5'200 1000+ 2= 2000 
30'200 6000+ *2= 12000 
200*200 4000 40000 
5° 30 150+ "2= 300 
30* 30 900 900 
200°30 6o00+ 
55 25 25 
30* 5 150+ 
200* 5 1000+ 
55225 55225 
mit + gekennzeichnete Produkte sind doppelt 








Bild 5: Schnelle Berechnung von Quadraten 
am Beispiel 235 


ren drei Bits gelöscht. Die Satzzeichen 
unterscheiden sich aber von den Leer- 
zeichen dadurch, daß ihnen (meist) noch 
ein Leerzeichen folgt. Die Leerzeichen 
kommen zwar nur in größerem Abstand 
vor, aber sie geben dann jeweils einen 
Hinweis auf fünf Bits der Pseudozufalls- 
zahl. Diese Methode erscheint mir si- 
cherer als die Verschlüsselung mit den 
unteren 8 Bits. 

Da die Leerzeichen bei Verwendung 
von nur 5 Bits leicht zu finden sind, 
sollten wir diese am besten gar nicht 
verschlüsseln. Sie können dann keinen 
Hinweis auf den Schlüssel geben. 

Je nach Anwendung können wir die 
erlaubten Zeichen einschränken. Wir 
können z.B. die oberen drei Bits gene- 
rell löschen oder setzen. Dabei wird 
jedoch der Zeichensatz auf 32 Zeichen 
eingeschränkt. Damit die Satzzeichen 
noch erkannt werden können, müssen 
sie umcodiert werden (ab besten auf die 
Zahlen zwischen 26 und 32). 

Wenn weiterhin alle Zeichen möglich 


“sein sollen, können wir die Zeichen auf 


mehrere Zeichensätze verteilen. In die- 
sem Fallmüssen wirnoch Umschaltzei- 
chen definieren, die dem Decodierpro- 
gramm signalisieren, daß das nächste 
Zeichen aus einem anderen Zeichen- 
satz kommt. Da einige Zeichen durch 
zwei Zeichen ersetzt werden, wird der 
Text dadurch etwas länger. Die Zei- 
chen, die am häufigsten vorkommen, 
sollten im Standardzeichensatz stehen. 

Beinormalen Texten empfiehltessich, 
als Standardzeichensatz die Kleinbuch- 
staben und das Leerzeichen zu definie- 
ren. Der größte Wert signalisiert dann, 
daß es sich bei dem nächsten Zeichen 
um einen Großbuchstaben handelt. 
Werden mehr als zwei Zeichensätze 
verwendet, stellt sich die Frage, ob wir 
im Standardzeichensatz für jeden wei- 
teren Zeichensatz ein Umschaltzeichen 
definieren (also z.B. 31 für Alternativzei- 
chensatz 1, 30 für Alternativzeichen- 
satz 2), oder ob wir in jedem - außerdem 
letzten - Zeichensatz den gleichen Wert 
zum Weiterschalten auf den nächsten 
Zeichensatz verwenden. Die zweite 
Methode hat den Vorteil, daß wir mehr 
Zeichen im Standardzeichensatz unter- 
bringen können. Die Zeichen in den 
anderen Zeichensätzen sollten dafür 
möglichst selten benötigt werden. 

In [2] wird gezeigt, wie man den Start- 
wert des PSZZG ermitteln kann, wenn 
dieser mit der Formel 
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X = FRAC(997°%) 


arbeitet. Diese Funktion wurde in [1] 
verwendet. Die Unsicherheit liegt in der 
begrenzten Mantisse der Fließkomma- 
zahlen. 

Ein Wechsel der Funktionsvorschrift 
für den PSZZG hilft also nicht unbe- 
dingt, das Verfahren sicherer zu machen. 

Damit der Startwert des PSZZG nicht 
so leicht ermittelt werden kann, sollte 
der PSZZG möglichst viele Werte er- 
zeugen können. Je mehr Bits für die 
Zahl verwendet werden, desto größer 
wird der Aufwand, um die Bits zu ermit- 
teln. Ein Verfahren ist dann sicher, wenn 
die Computer lange (bis zu mehreren 
Jahren) benötigen würden, um den 
Schlüssel zu finden. 

Es gibt allerdings auch beim besten 
PSZZG Bereiche, die nicht so sicher 
sind. Wird z.B. ein PSZZG auf der Basis 
von Schieberegistern mit sehr vielen 
Bits verwendet und als Startwert 256 
genommen (oder bald erreicht), haben 
die nächsten (p-8) Zahlen in den unte- 
ren 8 Bits nur Nullen stehen. Der ent- 
sprechende Textbereich wird dann nicht 
verschlüsselt. Es hilft natürlich nichts, 
stattdessen z.B. andere 8 Bits zu ver- 
wenden. Wir haben das gleiche Pro- 
blem, nur bei einer anderen Startzahl. 
Man sollte am besten einen Startwert 
verwenden, bei dem die 1-Bits gut über 
die ganze Zahl verteilt sind. BeiVerwen- 
dung einer größeren Dezimation wer- 
den diese Bereiche schneller verlassen. 

Wir können bei der Exklusiv-Oder- 
Verknüpfung auch die Zahlen übersprin- 
gen, die in den unteren 8 Bits nur Nullen 
haben. Solange nur wenige Buchsta- 
ben uncodiert bleiben, lohnt sich der 
Aufwand für die Überprüfung nicht. 


Nachwirkung 


Betrachten wir nun ein paar Verfahren, 
die beim Verschlüsseln derZeichen auch 
die vorhergehenden Zeichen berück- 
sichtigen. 

Eine recht einfache Methode besteht 
darin, die (ASCII-)Werte der Zeichen zu 
addieren. Wenn das Ergebnis größer 
als 255 (der größte erlaubte Wert) ist, 
subtrahieren wir 256 von dem Ergebnis. 
Für das erste Zeichen können wir einen 
Wert als Schlüssel vorgeben. Dieser 
Schlüssel wirkt aber nur auf das erste 
Zeichen. 

Eine leichte Abwandlung des Verfah- 
rens addiert zusätzlich noch eine Kon- 
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stante (Listing 3). Dadurch ergeben sich 
255 verschiedene Codiermöglichkeiten. 
Füreinen Computer also noch eine Klei- 
nigkeit. 

Da wir bereits Verfahren mit Exklusiv- 
Oder-Verknüpfung kennengelernt ha- 
ben, liegt es nahe, hier ebenfalls dieses 
Verfahren zu verwenden. Wir können 
den ASCII-Wert des Zeichens mit dem 
Wert des vorhergehenden Zeichens 
verknüpfen. Dies führt allerdings dazu, 
daß bei Doppelbuchstaben jeweils der 
zweite Buchstabe den Wert O erhält. 
Dies können wir vermeiden, wenn wir 
nicht den ASCII-Wert des Zeichens im 
Klartext verwenden, sondern den Wert 
des verschlüsselten Zeichens. In die- 
sem Fall ergibt sich der Schlüssel durch 


Bereich Anzahl 


bis 100 22 
bis 10° 
bis 10° 
bis 10° 


134 
7493 
63733 
bis 107 558037 

10° bis 10'+10* 487 
10'? bis 10'+2000 90 





Verknüpfung sämtlicher vorhergehen- 
der Zeichen. 

Die bisher beschriebenen Verfahren, 
die vom vorhergehenden Text abhän- 
gen, haben gemeinsam, daß man den 
Text leicht entschlüsseln kann, sofern 
das Verfahren bekannt ist. 

Wenn das Verfahren sicherer werden 
soll, müssen wir andere Verfahren mit 
integrieren. In Listing 4 wird nicht nur 
der ASCII-Wert des Zeichens zum letz- 
ten Ergebnis sowie ein zusätzlicher Off- 
set addiert, sondern zusätzlich eine 
Umcodierung über eine Vertau- 
schungstabelle durchgeführt. 

Im Listing wird die Umcodierung zwei- 
mal durchgeführt. Man kann das Ver- 
fahren sicherer machen, indem man 
noch ein paar Stufen einführt. Durch die 
Verwendung von Variablen, deren letz- 
tes Zeichen die Stufe angibt, zu der es 
gehört, sollte es für jeden möglich sein, 
weitere Stufen einzubauen. Jede zu- 
sätzliche Stufe ergibt 256mal soviel 
mögliche Verschlüsselungsarten. 

Da der Startwert für den PSZZG eben- 
falls ein Schlüssel ist, erhöht sich die 
Anzahl der Verschlüsselungsmöglich- 
keiten weiter. Ich habe mir jetzt keine 


Gedanken gemacht, ob der Faktor für 
die zusätzlichen Möglichkeiten so groß 
ist wie die Anzahl der Zahlen, die der 
gewählte PSZZGiliefern kann. Aufjeden 
Fall ist der Faktor größer als 256. 


Welchen Schlüssel 
nehmen wir jetzt? 


Nachdem wir uns eine ganze Anzahl an 
Verfahren angesehen haben, wollen wir 
uns mal überlegen, ob ein brauchbares 
dabei ist. Von den hier vorgestellten 
Verfahren erscheint mir eine Kombina- 
tion der Verschlüsselung mit Exklusiv- 
Oder mit Pseudozufallszahlen und der 
Vertauschung der Buchstaben nach 
Pseudozufallszahlen recht sicher zu 


Prozent 


Bild 6: Häufigkeit von 
Primzahlen 


sein. Die Verschlüsselung mit Exklusiv- 
Oder verhindert, daß man die Reihen- 
folge der Buchstaben herausbekommt. 
Die Vertauschung der Buchstaben ver- 
hindert, daß man die Bit-Kombination 
für den PSZZG für die Exklusiv-Oder- 
Verschlüsselung ermitteln kann. 

Wir müssen allerdings zwei unabhän- 
gige PSZZG zur Berechnung der Zu- 
fallszahlen verwenden. Würden wir nur 
eine Folge von Zufallszahlen verwen- 
den, könnte es passieren, daß wir nicht 
alle Positionen errechnen können. Wenn 
bei der Exklusiv-Oder-Verschlüsselung 
nicht alle Möglichkeiten genutzt wer- 
den, so verringert sich nur die Sicher- 
heit des Verfahrens. Wir können durch- 
aus in beiden Fällen die gleiche Funk- 
tionsvorschrift verwenden. Wir müssen 
nur getrennte Reihen von Zufallszahlen 
benutzen. 

Im Listing 2 stehen schon die benötig- 
ten Zeilen. Wir müssen nur die als Kom- 
mentar gekennzeichneten Zeilen in der 
‘WHILE’ - Schleife freigeben (Zeilen 32, 
35,36,39 und 40). Die beiden Zeilen (34 
und 38), die bisher das Ver- bzw. Ent- 
schlüsseln erledigten, müssen gesperrt 
werden. Allerdings passiert nichts, wenn 


sie nicht gesperrt werden, da das Zei- 
chen, das durch die Zeile verschoben 
wurde, gleich ersetzt wird. Diese Zeilen 
kosten also in diesem Fall ‘nur’ Zeit. 

Man könnte die Konstanten für den 
PSZZG (also Anzahl Bits und mittlerer 
Abgriff, eventuell auch Dezimation) als 
zusätzliche Schlüssel definieren. Da 
die Sicherheit des Verfahrens aber mit 
der Anzahl der Bits des PSZZG zu- 
nimmt, halte ich das nicht für sinnvoll. 
Wenn man einen PSZZG mit Dezimati- 
on verwendet, kann man sie eventu- 
ell als zusätzlichen Schlüssel verwen- 
den. Man muß jedoch beachten, daß 
nur sehr wenige Dezimationen möglich 
sind. 

Wird die Verschlüsselung bei der Da- 
tenübertragung verwendet, müssensich 
Sender und Empfänger auf ein bestimm- 
tes Format für die Verschlüsselung eini- 
gen. Damit sage ich Ihnen wohl nichts 
Neues. Aber stellen Sie sich mal vor, in 
einer Gruppe von einigen hundert Per- 
sonen will jeder mitjedem verschlüssel- 
te Daten austauschen. Dabei sollen die 
anderen die Daten nicht entschlüsseln 
können. Man kann dabei natürlich nicht 
hunderte von Verschlüsselungspro- 
grammen verwenden. Man muß sich 
schon auf ein Verfahren einigen. 

Haben wir uns auf ein Verfahren ge- 
eignet, können wir mit den anderen 
jeweils die geheimen Schlüssel verab- 
reden. Wir legen uns also eine Liste der 
Schlüssel an, die dann sicher verwahrt 
werden muß (man kann wohl kaum alle 
Schlüssel im Kopf behalten). Jedesmal, 
wenn wir Daten übertragen wollen, 
müssen wirnachsehen, welcher Schlüs- 
sel zu verwenden ist. Dabei darf natür- 
lich kein anderer den Schlüssel einse- 
hen können. 

Stellen wir uns vor, wir haben von 
jemandem eine Mitteilung im elektroni- 
schen Briefkasten. Wir wissen nicht, 
wer sie uns geschickt hat. Wir müssen 
dann alle möglichen Schlüssel testen, 
bis wir den richtigen gefunden haben. 

Es wäre doch viel besser, wenn wir 
einen einzigen Schlüssel wählen könn- 
ten, den dann alle verwenden, die uns 
Nachrichten übermitteln wollen. Wenn 
alle den gleichen Schlüssel nehmen, 
müssen wir ihn auch nicht mehr ge- 
heimhalten. Er ist jasowieso schon be- 
kannt. Man könnte die Schlüssel veröf- 
fentlichen wie ein Telefonbuch. Natür- 
lich sollen Nachrichten trotzdem sicher 
verschlüsselt sein. 
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Die hier vorgestellten Verfahren sind 
dafür nicht geeignet. Wenn wir eine 
Datei entschlüsseln wollen, geben wir 
den gleichen Schlüssel ein, mit dem sie 
verschlüsselt wurde. Mankannsich also 
fragen, ob es solche Verfahren über- 
haupt gibt. Die Frage kann inzwischen 
mit ja beantwortet werden. Diese Ver- 
fahren werden als ‘PUBLIC KEY’-Ver- 
fahren bezeichnet. 


Schlüssel bitte 
weitergeben 


Bei einem ‘Public Key’-Verfahren gibt 
es einen Schlüssel zum Ve- und einen 
anderen zum Entschlüsseln. Entschei- 
dend ist, daß der Schlüssel für die Ent- 
schlüsselung nicht aus dem für die Ver- 
schlüsselung ermittelt werden kann. Da 
es einen eindeutigen Zusammenhang 
zwischen den beiden Schlüsseln geben 
muß, basiert die Sicherheit der ‘Public 
Key’-Verfahren darauf, daß der Aufwand 
zur Ermittlung des Decodierschlüssels 
so groß wird, daß selbst schnelle Com- 
puter dafür Jahrzehnte oder sogar Jahr- 
tausende benötigen würden.. 

Angesichts derschnellen Entwicklung 
bei Computern heißt dies, daß ein be- 
stimmter Schlüssel nurfür einebegrenz- 
te Zeit sicher ist. Wenn die heutigen 
Computerallerdings einige Jahrtausen- 
de benötigen, um den Schlüssel zu er- 
mitteln, dürfte das Verfahren noch eini- 
ge Zeit sicher sein. 

Das erste ‘Public Key’-Verfahren wur- 
de 1976 von den drei Mathematikern 
Ronald Rivest, Adi Shamir und Leonard 
Adleman entwickelt und 1978 in [5] ver- 
öffentlicht. Nach den Anfangsbuchsta- 
ben-ihrer Namen wird dieses Verfahren 
meist als ‘RSA’-Verfahren bezeichnet. 

Wir wollen uns heute mit diesem Ver- 
fahren beschäftigen. Zunächst wollen 
wir uns ansehen, wie es funktioniert. 
Danach sehen wir uns an, wie wir uns 
einen Schlüssel dafür beschaffen. Es 
folgen einige Bemerkungen zu den Pro- 
grammen. Zum Schluß wollen wir noch 
ein paar Überlegungen zur Sicherheit 
des Verfahrens anstellen. 


Das RSA-Verfahren 


Beim RSA-Verfahren gibtes drei Schlüs- 
selzahlen. Wir bezeichnen die drei 
Schlüssel mit S,\T undN. Die Schlüssel- 
zahl ‘S’ wird nur beim Ver-, ‘T’ nur beim 
Entschlüsseln, und ‘N’ beide Male be- 
nötigt. 


Bei diesem Verfahren werden Zahlen 
ver- bzw. entschlüsselt. Eine Zahl ‘X’ 
wird beim Verschlüsseln in eine Zahl ‘Y’ 
überführt. Die Funktionsvorschriften 
sind: 


Verschlüsseln: Y =X® mod N 
Entschlüsseln: X = Y' mod N 


Der Operator ‘mod’ dürfte den meisten 
bekannt sein. Es handelt sich dabei um 
die Modulo-Division. Das Ergebnis ist 
also der Rest, der bei der Division übrig- 
bleibt. 

Wenn die drei Schlüsselzahlen richtig 
gewählt werden, so wird jede Zahl ‘X’, 
die kleiner ist als ‘N’, eindeutig auf eine 
andere Zahl (Y) im Bereich zwischen O 
und N abgebildet. 

Auf den ersten Blick handelt es sich 
bei diesem nur um eine Variante des 
Verfahrens, bei dem die Buchstaben 
(bzw. deren ASCll-Werte) willkürlich 
gegen andere Buchstaben vertauscht 
werden. 

Wenn wir für ‘X’ jeweils den ASCII- 
Wert eines Zeichens verwenden, han- 
delt es sich hier wirklich nur um dieses 
Verfahren. Es hat dann nur den Nach- 
teil, daß die Zahlen ‘Y’ größer als 255 
werden können (max. n-1) und die Ver- 
schlüsselung länger dauert. 

Damit das Verfahren sicher wird, müs- 
sen wir mehrere Zeichen zusammen- 
fassen. Selbst in längeren Texten wer- 
den dann nur ganz selten mehrfach die 
gleichen Zeichensequenzen zusam- 
mengefaßt. Da die ASCII-Zeichen Zah- 
len bis 255 entsprechen, können wir 
mehrere Zeichen eindeutig zusammen- 
fassen, indem wir die weiteren Zeichen 
mit 256 multiplizieren [P=1,2..]. Wir er- 
sparen uns natürlich die Multiplikation 
und betrachten p aufeinanderfolgende 
Zeichen einfach alseine p*8-Bit-Integer- 
zahl. Die Zahl muß natürlich kleiner als 
‘N’ sein. Wir wählen daher p so groß, 
daß ‘X’ gerade noch kleiner als ‘N’ ist. 

Es ist sinnvoll, für ‘X’ soviel Zeichen 
wie möglich zusammenzufassen, weil 
die Anzahl der Berechnungen damit 
möglichst klein gehalten wird. Außer- 
dem ist der Längenunterschied zwi- 
schen dem Klartext und dem verschlüs- 
selten Text dabei am geringsten. 


Die Schlüssel 


Sehen wir uns die Bedingungen für die 
Schlüsselzahlen an: 
Für die Zahl ‘N’ gilt, daß es sich dabei 
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um das Produkt von zwei beliebigen 
(großen) Primzahlen ‘P’ und ‘Q’ handeln 
muß. Diese beiden Primzahlen sind der 
entscheidende Ausgangspunkt für die 
Schlüssel. Sie müssen daher geheim- 
gehaltenwerden. Zur Ermittlung der an- 
deren beiden Schlüssel benötigen wir 
noch eine weitere geheimzuhaltende 
Zahl ‘F’. Sie wird nach der FormelF=(P 
-1)*(Q-1)=N-P-Q+ berechnet. Für 
die Zahl ‘'S’ gelten die Bedingungen, 
daß ‘S’kleiner als ‘F’ sein muß und mit 
‘F’ keinen ge-meinsamen Teiler haben 
darf. Für die Schlüsselzahl ‘T’ gilt: (S*T) 
mod F= 1. Diese Aussage istäquivalent 
mit der Aussage (S*T)=a*F+1.Dabei 
ist ‘a’ eine ganze Zahl. Die Zahl ‘T’ muß 
ebenfalls geheim bleiben. In Bild 3 sind 
die Bedingungen noch einmal zusam- 
mengefaßt. Mit den so ermittelten 
Schlüsselzahlen wird jede Zahl ‘X’, die 
kleiner ist als ‘N’, beim Verschlüsseln 
eindeutig in eine Zahl ‘Y’ überführt, die 
ebenfalls kleiner als ‘N’ ist. Den Beweis 
dafür wollen wir hier nicht antreten. 

Ich möchte aber noch darauf hinwei- 
sen, daß die Zahlen ‘'S’ und ‘T’ ausge- 
tauscht werden können. Wir können 
also auch die Verschlüsselung mit der 
Vorschrift Y=X’modN vornehmen und 
dann mit X = Y® mod N wieder ent- 
schlüsseln. Es reicht also, wenn einer 
der beiden Schlüssel keinen gemeinsa- 
men Teiler mit ‘F’ hat. Sie werden sich 
jetzt sicher fragen, was Sie davon ha- 
ben, wenn Sie die beiden Schlüsselzah- 
len austauschen können: Die Zeit für die 
Ver- bzw. Entschlüsselung hängt von 
der Größe der Schlüsselzahl ‘S’ bzw. ‘T’ 
ab. Wird ein verschlüsselter Text häufi- 
ger entschlüsselt, kann man Zeit spa- 
ren, wenn ‘T’ möglichst klein ist. Wird 
der Text auf verschiedenen Computern 
ver- und entschlüsselt, kann man dem 
schnelleren Computer den größeren 
Schlüssel zuordnen. 

Da es sich bei diesem Verfahren um 
ein ‘Public Key’-Verfahren handelt, kön- 
nen wir die beiden Zahlen, die zum 
Verschlüsseln benötigt werden (‘N’ und 
‘S’), veröffentlichen. Außenstehende 
sind nichtin der Lage, dieSchlüsselzahl 
“T’ in kurzer Zeit zu ermitteln, sofern wir 
für ‘N’ eine sehr große Zahl verwenden. 
Die erforderliche Größe von ‘N’ hängt 
dabei vonderRechenleistungder Com- 
puter ab. Je schneller die Computer 
werden, desto größer muß ‘N’ werden. 
Wir werden nachher noch die Zeiten 
abschätzen, die dafür nötig sind. 
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Die Programme 


Nachdem wir wissen, wie der Algorith- 
mus aussieht, können wir uns dem Pro- 
gramm zuwenden (Die beiden Assem- 
bler- und das GFA-Programme befin- 
den sich auf den Disketten zum Heft). 

Im ersten Assemblerprogramm ist die 
Funktion zum Ver- und Entschlüsseln 
von Speicherbereichen realisiert. Die 
Schlüsselzahlen werden als 127-Bit-In- 
tegerzahlen übergeben. Damit können 
für die Schlüsselzahlen bis zu 38stellige 
Zahlen verwendet werden [max. 
127*log,,(2)]. Die Begrenzung habe ich 
so gewählt, weil 


1) der Aufwand zur Ermittlung der 
Schlüsselzahlen sonst (auf dem Atari 
ST) zu groß wird, 

2) wir bei größeren Zahlen die Modulo- 
division nicht mehr in den Registern 
des Prozessors durchführen können. 
Die benötigte Rechenzeit würde da- 
mit drastisch ansteigen. 


Die Anzahl der Zeichen, die jeweils zu 
einer Zahl zusammengefaßt werden, 
richtet sich nach der Größe von ‘N’. Es 
wird ein Byte weniger verwendet, als 
zum Speichern von ‘N’ benötigt wer- 
den. Ist ‘N’ z.B. eine Zahl mit 100 Bits, 
werden zur Darstellung der Zahl 13 Bytes 
benötigt. Für die Zahl ‘X’ werden dann 
jeweils 12 Bytes zusammengefaßt. Die 
Zahl ‘Y’ hat 13 Byte, weil das Ergebnis 
der Berechnung max. N-1 ist. Wir benö- 
tigen für das Ergebnis genauso viel Bits 
wie für ‘N’. Man könnte die Anzahl Bytes, 
die jeweils zu einer Zahl ‘X’ zusammen- 
gefaßt werden, variabelmachen: Istdas 
erste Zeichen für ‘X’ kleiner als das 
höchste Byte (MSB) von ‘N’ [aber un- 
gleich 0], könnten wir ein Zeichen mehr 
für die Zahl ‘X’ verwenden. Insbesonde- 
re, wenn das MSB von ‘N’ größer als 
128 ist, würde der verschlüsselte Text 
kaum länger sein als der Klartext. Ich 
habe auf diese Möglichkeit verzichtet, 
weil man dann nicht mehr ausrechnen 
kann, an welcher Stelle im verschlüs- 
selten Text eine bestimmte Textpassa- 
ge steht. Man kann jetzt durchaus ein- 
zelne Abschnitte des verschlüsselten 
Textes durch einen anderen Text erset- 
zen. 

Entsprechend dem üblichen Zahlen- 
format bei Motorola ist das erste Zei- 
chen der jeweiligen Zeichenkette das 
MSB. Beim Datenaustausch mit Com- 


putern, die Intel-Prozessoren verwen- 
den, muß man darauf achten, daß sie 
das gleiche Format verwenden. 


Rechnen mit Resten 


Den größte Teil des Listings nimmt die 
Funktion zum Berechnen von ad? mod N 
ein. Wir wollen uns daher etwas aus- 
führlicher darauf eingehen. 

Wir benötigen das genaue Ergebnis 
der Berechnung und können daher nicht 
auf die Berechnung mit Fließkomma- 
zahlen zurückgreifen. Wir können aber 
auchnichtzunächsta® berechnen. Wenn 
die Zahl a 100 Bits hat, benötigen wir für 
a? bereits 200 Bits. Für ab benötigen 
b*100 Bits. Jeder noch so große Spei- 
cher ist dafür zu klein. Die Berechnung 
würde auch zu lange dauern. 

Wir sind allerdings auch nicht an dem 
Ergebnis von ab interessiert, sondern 
an dem Ergebnis von a” mod N. Wir 
können ausnutzen, daß (c * d) mode 
das gleiche Ergebnis liefert wie ((c mod 
e) * (d mod e)) mod e. Die Zahl a® 
könnten wir auch als Produkt von b mal 
den Faktor a schreiben. Wir müßten 
dann b-1 mal mit a multiplizieren und 
die Modulodivision durchführen. Wir 
können aber auch die Zahl b in ihre 
Zweierpotenzen zerlegen und dann die 
entsprechenden Potenzen von a mo- 
dulo N berechnen. Die Zweierpotenzen 
werden als Produkt der jeweils nächst- 
kleineren Zweierpotenz berechnet (a’x= 
aa’). Es reichen dann weniger als 
2*log,(b) anstatt b Multiplikationen. Da- 
bei werden /og,(b) Multiplikationen zur 
Ermittlung der Zweierpotenzen benö- 
tigt. Für jedes gesetzte Bit in b ist dann 
noch die Multiplikation des Teilergeb- 
nisses mit der entsprechenden Zweier- 
potenz durchzuführen. In Bild 2 ist dies 
an einem Beispiel dargestellt. 

Die Berechnung von (c * d) mod e 
könnte man analog durch Additionen 
und Subtraktionen zurückführen. Die 
Berechnung geht allerdings schneller, 
wenn wir bei der Multiplikation und Di- 
vision bleiben. In Assembler können wir 
jaentsprechend mehr Platz für das Zwi- 
schenergebnis reservieren. 

Wer sich das Listing ansieht, wird 
wahrscheinlich erstaunt feststellen, daß 
neben der Funktion zur Berechnung 
von a*b (abmodn) ein zweiter Programm- 
teil zur Berechnung von a? (ah2modn) 
vorhanden ist. Der Grund liegt darin, 
daß ich a? schneller berechnen kann als 
a*b. Um dies zu verstehen, müssen wir 
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uns mal ansehen, wie wir mehrstellige 
Zahlen schriftlich multiplizieren: 

Wir multiplizieren jede Ziffer des er- 
sten Faktors mit jeder Ziffer des zweiten 
Faktors. Üblicherweise werden die Pro- 
dukte, die zu einer Ziffer des zweiten 
Produkts gehören, sofort addiert. Wür- 
den wir dies nicht machen, würden wir 
bei der Berechnung von a*a sehen, daß 
wir die meisten Produkte zweimal be- 
rechnen. Es reicht natürlich, wenn wir 
das Produkt der Ziffern einmal berech- 
nen und dann das Ergebnis zweimal 
addieren. Wir können also fast die Hälf- 








Es müssen zwei (große) Zahlen vorgegeben werden (max. 19 Ziffern) 


bitte 1. Zahl vorgeben: 999999999. __.__| 
bitte 2. Zahl vorgeben: 888888888._ . | 
P = 1.000.000.007 00:00:00,39 21:25:36 
888.888.893 3.491 00:00:00,44 21:25:38 
888.888.899 19.141 00:00:00,68 21:25:38 
Q= 888.888.901 00:00:01,05 21:25:38 


Kombinationen für N = 888.888.907.222.222.307 00:00:01,06 21:25:38 
S=271T = 9.840.098.583.025.831 a=3 00:03:41,66 21:29:18 
S = 77.837.087 T = 45.679.453.823 a=4 00:03:48,69 21:29:26 
S=17 T =261.437.913.333.333.3593 a=5 00:08:02,43 21:33:38 


te der Multiplikationen sparen. In Bild 5 
habe ich die Berechnung von 235? mal 
entsprechend aufgeschlüsselt. 

Im Assemblerprogramm befindetsicht 
nur direkt die Verschlüsselungsroutine. 
Der Funktion werden die Parameter ‘C’- 
kompatibel übergeben. Für dieanderen 
Aufgaben reicht die Geschwindigkeit 
einer Hochsprache. Diese Aufgaben 
werden von einem GFA-BASIC-Pro- 
gramm erledigt. Das BASIC-Programm 
lädt die Assembler-Routine nach. Dazu 
wird das Listing 6 wie ein normales, 
eigenständiges Programm assembliert 
und in ‘CRYPTRSA.ASM’ umbenannt. 
Dadurch soll verdeutlicht werden, daß 
es sich nicht um ein eigenständig lauf- 
fähiges Programm handelt. Beim ‘DEV- 
PAC’-Assembler, mit dem ich das Pro- 
gramm geschrieben habe, hätte man 
das Programm auch als Binär-File spei- 
chern können. In diesem Fall würde der 
‘SEEK’-Befehl entfallen. Ich weiß aber 
nicht, ob alle Assembler diese Möglich- 
keit bieten. Ein Programm kann man 
jedoch mit jedem Assembler erzeugen. 
Damit das Listing möglichst unverän- 
dert auch von anderen Assemblern ver- 
arbeitet wird, habe ich die Offset-Tabel- 
le über 'EQU’ definiert. 

DadieSchlüsselzahlen sehr groß sind, 
werden sie nicht im Dialog erfragt, son- 
dern sind in den DATA-Statements ab- 
gelegt. Wenn man die Schlüsselzahl ‘T’ 
mit einträgt, muß man natürlich dafür 
sorgen, daß diese Programmversion 
nicht von anderen Personen genutzt 
werden kann. Man sollte das Programm 
dann genauso sicher aufbewahren wie 
seine Tresorschlüssel. Man sollte sich 
vielleicht zwei Versionen des Pro- 
gramms machen. Die eine enthält nur 
die Schlüssel zum Verschlüsseln von 
Daten. Diese Version kann man bei sei- 
nen normalen Disketten lagern oder auf 
der Festplatte ablegen. 
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N = 888.888.907.222.222.307 
S=271T = 9.840.098.583.025.831 

S = 77.837.087 T = 45.679.453.823 
S=17 T =261.437.913.333.333.353 





Bild 7: Ein verkürzter Lauf des Programms zur Berechnung von Schlüsselzahlen 


Die andere Version die den persönli- 
chen Decodierschlüssel enthält, wird 
gut verschlossen aufbewahrt. 

Die Schlüsselzahlen dürfen (Tausen- 
der-)Punkte enthalten. Wenn man eine 
so große Zahl eingibt, kann man schon 
leicht Fehler machen. Ist die Zahl in 
Dreiergruppen unterteilt, kann man sie 
leichter vergleichen. 

ImListingsind ein paar Beispielschlüs- 
sel eingetragen. Die ersten beiden Schlüs- 
sel ergänzen sich. Im ersten Schlüssel 
fehlt die Schlüsselzahl ‘S’, im Zweiten die 
Zahl ‘T’. Zum letzten Schlüssel kennt nur 
mein Programm die Schlüsselzahl ‘T’. 

Das Unterprogramm 's_to_i’ wandelt 
den String mit der Zahl in eine 128-Bit- 
Zahl um. Man sieht daran, daß man 
auch in BASIC mit sehr großen Zahlen 
umgehen kann. Der Aufwand wird da- 
bei nur größer und das Programm lang- 
samer. 

Das Programm kann im Dialog ge- 
nutzt werden. Dabei werden die Quell- 
und Zieldatei über die bekannte Dialog- 
box erfragt. Danach wird gefragt, wel- 
cher Schlüssel verwendet werden soll. 
Als letztes gibt man noch aan, ob man die 
Quelldatei ver- oder entschlüsseln will. 
Damansich dieNummerfür den Schlüs- 
sel nicht so gut merken kann, kann man 
das Programm eventuelländern, so daß 
jedem Schlüssel ein Name zugeordnet 
wird. Der Schlüssel wird dann nach 
dem Namen des Adressaten gesucht. 
Die bequemste Wahlmöglichkeit bietet 
wohl eine Dialogbox, in der die Namen 
eingetragen werden. 





Eine andere Möglichkeit ist der Aufru 
als ‘TTP’-Anwendung. In diesem Fal 
wird als erstes ein ‘C’ oder ein ‘D' für 
Codieren bzw. Decodieren eingegeben. 
Dahinterfolgen die Nummer des Schlüs- 
sels sowie die Dateinamen für die Quell- 
und Zieldatei. Die einzelnen Eingabe- 
parameter werden durch Leerzeichen 
getrennt. Das erste Zeichen des Com- 
mandstrings darf (wie beim Aufruf vom 
Desktop aus) dessen Länge enthalten. 
Der String wird aber auch korrekt bear- 
beitet, wenn diese Angabe nicht vor- 
handen ist. Die Parameterübergabeüber 
den Commandstring ist allerdings nur 
beim compilierten Programm verwend- 
bar. Wird das Programm über ‘Anwen- 
dung anmelden’ vom Desktop aus ge- 
startet, enthält der Commandstring den 
Namen der BASIC-Datei. Das Pro- 
gramm meldet dann ‘Befehl nicht er- 
kannt’. Damit das Programm gestartet 
werden kann, muß man an den Anfang 
der Commandline ein 0-Byte schreiben: 





POKE BASEPAGE+128,0 


Damit jede Datei eindeutig wieder ent- 
schlüsselt werden kann, wird vor dem 
Verschlüsseln hinter dem Klartext ein 
$FF-Byte geschrieben. Nach dem De- 
codieren wird diezurückgegebeneLän- 
ge nach diesem $FF-Byte korrigiert. 
Hinterdem$FF-Bytefolgen nurO-Bytes. 

Um das Programm zu testen, nehmen 
wir einen kurzen Textund verschlüsseln 
ihn. Anschließend wird der Text wieder 
decodiert und unter einem anderen 
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Namen gespeichert. Jetzt können wir 
prüfen, ob die Dateien identisch sind. 


Berechnung der Schlüssel 


Wir sind jetzt in der Lage, Daten zu ver- 
und zu entschlüsseln, sofern uns je- 
mand die benötigten Schlüsselzahlen 
gibt. Damit unser persönlicher Schlüs- 
sel wirklich geheim ist, wollen wir ihn 
natürlich selbst ermitteln. Wenden wir 
uns daher jetzt der Berechnung der 
Schlüsselzahlen zu (Zweites (Assem- 
bler-)Program auf den Disketten.) 

Wir haben bereits erfahren, daß die 
Zahl ‘N’ das Produkt von zwei Primzah- 
len ist. Wir müssen also zunächst zwei 
Primzahlen ermitteln. 

Wir erinnern uns an die Definition von 
Primzahlen: 


Eine Zahl ist eine Primzahl, wenn sienur 
durch Eins und durch sich selbst ohne 
Rest teilbar ist. 


Wir nehmen uns also eine beliebige 
Zahlundteilensie durch alle Zahlen, die 
kleiner sind als diese Zahl. Bleibt dabei 
einmal kein Rest, können wir aufhören, 
da wir uns keine Primzahl ausgesucht 
haben. Wir müssen dann bei dernächst- 
größeren Zahl wieder von vorn anfan- 
gen. Wenn man sich die Anzahl der 
erforderlichen Divisionen vorstellt, über- 
legt man sich, ob man nicht mit weniger 
Divisionen auskommen kann: 

Es reicht, wenn man durch die Zahlen 
teilt, die kleiner sind als die Wurzel der 
Zahl. Ist der Divisor größer als die Wur- 
zel, wird das Ergebnis kleiner. Bei der 
Division durch das Ergebnis hätten wir 
bereits gemerkt, daß es sich nicht um 
eine Primzahl handelt. 

Da die Primzahl ungerade ist (zwei ist 
die einzige gerade Primzahl, weil alle 
geraden Zahlen durch zweiteilbar sind), 
müssen die möglichen Teiler ebenfalls 
ungerade sein. 

Wir haben jetzt die Anzahl der erfor- 
derlichen Divisionen schon erheblich 
reduziert, sind aber noch nicht zufrie- 
den. Es würde doch reichen, wenn wir 
die Zahl nur durch die Primzahlen teilen. 
Wenn wir durch eine andere Zahl teilen, 
hätten wir bereits bei deren Primfakto- 
ren festgestellt, daß die Zahl keine Prim- 
zahl ist. Wenn wir die Primzahlen erst 
ermitteln müssen, wird der Aufwand 
dafür größer als die gesparte Zeit. 

Als Kompromiß können wir einen Teil 
der Nichtprimzahlen weglassen. Wir 


haben bereits alle Zahlen weggelassen, 
die durch zweiteilbar sind. Als nächstes 
lassen wir auch alle Zahlen weg, die 
durch drei teilbar sind. In diesem Fall 
müssen wir zum Divisor abwechselnd 
einmal Zwei und einmal Vier addieren 
(außer am Anfang). Je mehr Primzahlen 
wir berücksichtigen, desto komplizier- 
ter wird die Abstandsliste. 


Sieb des Eratosthenes 


Im 2. Jh. v. Chr. hat Eratosthenes ein 
Verfahren erdacht, mit dem alle Prim- 
zahlen bis zu einer bestimmten Zahl 
ermittelt werden können: Wir schreiben 
zunächst alle Zahlen auf. Nun beginnen 
wir bei der Zahl Zwei und streichen 
dann jede zweite Zahl aus der Liste. 
Nun sehen wir in der Liste nach, wel- 
ches die kleinste Zahl ist, dienoch nicht 
durchgestrichen ist. Wir finden dabei 
die Drei. Wir streichen daher jede dritte 
Zahl durch. Die Zahlen, die bereits 
durchgestrichen sind, müssen dabei 
mitgezählt werden. Dies wiederholen 
wir solange, bis wir alle Zahlen durch- 
getestet haben. 

Wenn wir nur die ersten Primzahlen 
sieben, haben wir eine Liste, in der ein 
Teil der Zahlen gestrichen ist, die keine 
Primzahlen sind. Da sich die Abstände 
ab dem Produkt der gesiebten Prim- 
zahlen wiederholen, können wir wieder 
am Anfang derListeanfangen. Dasheißt, 
nicht ganz am Anfang, da die Primzah- 
len selbst nicht durchgestrichen sind. 
Wir nehmen daher den Abschnitt hinter 
der größten gesiebten Primzahl. Im Pro- 
gramm werden noch die Abstände bis 
zur nächsten nicht gestrichenen Zahl 
ermittelt, damit wir die Zahlen nicht te- 
sten müssen. 

Da wir die geraden Zahlen gar nicht 
beachten müssen, wird in der Tabelle 
nur jeder zweite Platz verwendet. Der 
Bereich dazwischen findet für ein zwei- 
tes Teilsieb Verwendung. 

Wir wollen uns jetzt mal überlegen, 
wieviel Divisionen wir mit der aufwendi- 
gen Tabelle sparen: Wenn wir die Prim- 
zahl p zusätzlich sieben, wird jede p-te 
Zahl gestrichen. Ein Teil der Zahlen war 
zwar bereits gestrichen, aber der Anteil 
ist bei den nicht gestrichenen Zahlen 
genauso groß. Die Ersparnis liegt daher 
bei 1/p der bisherigen Zeit. Anders aus- 
gedrückt, wir können die Zeit mit (p-1)/ 
p multiplizieren. Werden alle Primzah- 
len von 3 bis 31 verwendet, ergibt sich 
als Faktor 0,306. Die benötigte Zeit wird 
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also auf ca. 30 Prozent reduziert. Da die 
Berücksichtigung der Zahl2 bereitseine 
Halbierung der zu prüfenden Zahlen 
brachte, müssen wir also ca. 15 Prozent 
der Zahlen überprüfen. In Bild 6 ist die 
Häufigkeit der Primzahlen für einige 
Bereiche angegeben. Wir sehen daran, 
daß wir ‘nur’ noch dreimal soviel Divi- 
sionen durchführen, wie mindestens 
erforderlich wären. 

In Bild 7 ist ein verkürzter Lauf des 
Programms wiedergegeben. Die bei- 
den Zeilen zwischen ‘P=' und ‘Q=’ zei- 
gen, bei welchen Zahlen zwischen der 
vorgegebenen Zahl und der Primzahl 
der kleinste Primfaktor schon etwas 
größer ist. Bei jeder Ausgabe werden 
die Rechenzeit und die Uhrzeit angege- 
ben. Bei dem Beispiel ist die Zeit noch 
nicht so interessant. Werden die Prim- 
zahlen aber größer, kann man besser 
abschätzen, wann die nächste Zahl 
ausgegeben wird. Ich wollte die Ausga- 
be der Zeit schon weglassen, aber so 
könnt Ihr Euch selbst von dem Anstieg 
der Rechenzeit überzeugen, ohne gleich 
große Zahlen vorgeben zu müssen. 

Wenn die vorgegebene Zahl eine De- 
zimalstelle mehr hat, dauert die Über- 
prüfung ca. dreimal so lange. Wird die 
größte 18stellige Zahl vorgegeben, dau- 
ertesca. 12,5 Std. bis die erste 19stel- 
lige Zahl gefunden wird. Geben wir die 
größte 19stellige Zahl vor, müssen wir 
ca. 60 Std. warten bevor feststeht, daß 
die Zahl (10°+51) die erste 20stellige 
Primzahl ist. In diesem Falldauertes ca. 
17 Std., bis das Programm den klein- 
sten Divisor von (10?°+49) gefunden hat. 
Da ich nicht so lange auf den Compu- 
ter verzichten will (die weiteren Zah- 
len müssen ja auch noch berechnet 
werden), kann die Berechnung alle 
paar Sekunden mit einem beliebigen 
Tastendruck unterbrochen werden. Man 
kann dann den aktuellen Stand spei- 
chern und die Berechnung irgendwann 
(z.B. in der nächsten Nacht) fortset- 
zen, indem man anstelle der ersten 
Primzahl ein ‘|’ für Laden eingibt. Wird 
bei der Eingabe nur die [RETURN]J-Ta- 
ste gedrückt, wird das Programm be- 
endet. 

Die Divisionen bei der Primzahlsuche 
werden von dem Unterprogramm ‘Rdi- 
vi’ durchgeführt. Dieses Unterprogramm 
ist für eine 64-Bit-Division relativ lang. 
Man könnte die Division auch mit weni- 
ger als 20 Zeilen durchführen. Durch die 
vielen Fallunterscheidungen benötigt die 
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Funktion allerdings weniger als die Hälfte 
der Zeit. 

Wenn wir uns zwei Primzahlen ausge- 
sucht haben, können wir ‘N’ und ‘F’ 
ausrechnen. Wie aber kommen wir an 
‘S’ und ‘'T’? 

In [6] wird vorgeschlagen, sich eine 
beliebige Zahl ‘a’ auszusuchen. Mit die- 
ser Zahl berechnen wirnun AFT=a*F 
+ 1. Das Ergebnis ist ein mögliches 
Produkt von ‘S’ und ‘T’. Nun zerlegen 
wir die Zahlen ‘AF1’ und ‘F’ in ihre 
Primfaktoren. Alle Primfaktoren von 
‘AF1’, die auch Primfaktoren von ‘F’ 
sind, werden für die Zahl ‘T’ verwendet. 
Die verbleibenden Zahlen werden so 
auf ‘S’ und ‘T’ verteilt, daß beide Zahlen 
in etwa gleich groß sind. 

Dieses Vorgehen ist zwar im Prinzip 
durchführbar, aber der Zeitaufwand 
kann sehr groß werden. Es besteht die 
Möglichkeit, daß die Zahl ‘AF1’ eine 
Primzahl ist. Die Zahl ‘F’ kann keine 
Primzahl sein, da sie das Produkt von 
zwei geraden Zahlen ist. Sie enthält 
zumindest zweimal den Primfaktor 2. 
Die Zahl F/4 kann aber schon eine Prim- 
zahl sein. 

Wir können uns die Zerlegung von ‘F’ 
in Primfaktoren sparen. Um zu prüfen, 
ob ein Primfaktor von ‘AF1’ auch ein 
Primfaktor von ‘F’ ist, müssen wir nur ‘F’ 
durch diese Zahl teilen. Da die Zahl 
‘AF1’ maximal ca. 80 Primfaktoren ha- 
ben kann (wenn es sich um 3* handelt), 
benötigen wir dafür erheblich weniger 
Zeit als für die Primfaktorzerlegung. Der 
Aufwand für eine vollständige Zerle- 
gung von ‘AF1’ wird meist ebenfalls zu 
groß sein. Wir begnügen uns daher da- 
mit, die Primfaktoren zu suchen, die 
kleiner als eine bestimmte Zahl sind. 
Der Rest von ‘AF1’ wird einfach als 
Faktor von ‘T' verwendet. Von den ge- 
fundenen Faktoren werden die Teiler 
von ‘F’ ebenfalls als Faktor von ‘T’ ver- 
wendet. Die verbleibenden Faktoren 
werden so aufgeteilt, daß ‘S’ und ‘T’ 
möglichst gleich groß werden. Bei gro- 
Ben Zahlen heißtdies in der Praxis meist, 
daß sie alle Faktoren von ‘S’ werden. 

Das Programm nimmt für die Zahl ‘a’ 
alle Werte von 3 bis 13. Man kann sich 
dann die Kombination für ‘S’ und ‘T’ 
aussuchen, bei derbeide Zahlen inetwa 
gleich groß sind. Nachdem alle Zahlen 
getestet wurden, werden nochmal alle 
gefundenen Kombinationen ausgege- 
ben. Dies gilt auch für die Kombinatio- 
nen, die vor eventuellen Unterbrechun- 


gen ermittelt wurden. Man muß diese 
Zahlen also nicht notieren. 


Ist das Verfahren 
wirklich sicher ? 


Um das Verfahren zu knacken, müssen 
wir die beiden Primzahlen finden, die für 
die Berechnung von ‘N’ verwendet wur- 
den. Die zweite Primzahl können wir 
natürlich sofort berechnen, wenn wir 
die erste haben. Sobald wir diese Prim- 
zahlen haben, können wir ‘F’ berech- 
nen. Um den fehlenden Schlüssel ‘T’ zu 
ermitteln, ist nur noch wenig Aufwand 
nötig. Aus dem Verhältnis von ‘S’ zu ‘F 
mod S’ kann man mögliche Werte für ‘a’ 
abschätzen. 

Es liegt nahe zu versuchen, ob wir ‘F’ 
nicht auch so raten können. Da F =(Q- 
1)*(P-1)= N-Q-P+1 ist, können wir zwar 
eine obere Grenzen für ‘F’ angeben: F< 
N-2*sgr(N). Istaberz.B.Q=P*10, ergibt 
sich F= N-3,5*sqr(N). Es müssen mehr 
Zahlen getestet werden als bei der Er- 
mittlung der Faktoren von ‘N’. Zudem 
kommen für ‘a’ jeweils sehr viele Zahlen 
in Frage. 

Die entscheidende Frage ist also, wie 
lange es - statistisch gesehen - dauert, 
bis wir einen Primfaktor von ‘N’ finden. 
Wie wir bereits bei der Ermittlung der 
Primzahlen gesehen haben, steigt die An- 
zahl der möglichen Teiler für eine Zahl 
mit deren Größe. Wird die Zahl um zwei 
Dezimalstellen größer (also hundertmal 
so groß), steigt die Anzahl der mögli- 
chen Teiler um den Faktor 10. Es spielt 
dabei kaum eine Rolle, ob wir nur die 
Primzahlen überprüfen oder - wie bei 
unserem Programm - die dreifache 
Menge. 

Setzen wir einen etwas schnelleren 
Computer voraus (z.B. einen Atari ST 
mit einem 16-MHz-Prozessor). Nehmen 
wir an, daß dieser Computer die erste 
20stellige Zahl in 24 Std. überprüfen 
kann. Für die Zahl ‘N’ nehmen wir an, 
daß Sie 38 Dezimalstellen hat. Da die 
Zahl 18 Dezimalstellen mehr hat, benö- 
tigt das Programm 109 Tage dafür. Dies 
entspricht 2,7 Millionen Jahre. Dabei 
wurde noch nicht berücksichtigt, daß 
die Division länger dauert, wenn die 
Zahlen größer sind. Wenn wir anneh- 
men, daß wir nur die Primzahlen prüfen, 
können wir den Zeitaufwand auf ca. 1 
Million Jahre reduzieren. 

Die geschätzten Zeiten beziehen sich 
auf den ungünstigsten Fall, daß wir bei 
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den kleinsten Primzahlen anfangen und die beiden Primzah- 
len ungefähr gleich groß sind. Wenn beide Primzahlen fast 
gleich groß sind, finden wir sie schneller, wenn wir bei Wurzel 
N anfangen und dann abwärts die Zahlen testen. 

Nehmen wir an, daß die größere Primzahl (Q) zehnmal so 
groß ist wie die kleinere (P), so ist P = sqr(N)/sgr(10) = sgr(N)/ 
3. Es hilft also nicht unbedingt, bei sqr(N) anzufangen. 

Nehmen wir an, daß wir die Primfaktoren nach einem 
Zehntel der möglichen Divisionen finden, so bleiben immer 
noch 100 000 Jahre. Die Zeitersparnis ist dabei schon recht 
großzügig gerechnet. 

Eine weitere Beschleunigung kann nur noch der Einsatz von 
Technik bringen. Die Rechengeschwindigkeit des STistzwar 
für viele Zwecke ausreichend, aber es gibt Computer, die 
erheblich schneller sind. Der Inbegriff für schnelle Computer 
ist sicherlich die ‘Cray’. Ich weiß nicht, wie lange dieser 
Computer für die Berechnung benötigen wird. Es ist auf 
jeden Fallmehr, als das Verhältnis der Taktfrequenzen ergibt. 
Die ‘Cray’ arbeitet mit 250 MHz, sie ist von daher also 
mindestens 30mal so schnell. 

Zusätzlich hat die Cray einen breiteren Datenbus und eine 
schnellere Architektur. Dadurch wird der Computer noch 
einmal schneller. 

Billigen wir einem Supercomputer zu, daß er 10000mal so 
schnell rechnet wie der ST, so benötigt er immer noch 10 
Jahre, um den Schlüssel zu ermitteln. Man könnte die Zeit 
natürlich verkürzen, wenn man die Arbeit auf mehrere Com- 
puter verteilen würden, aber wer hat schon mehrere Super- 
computer zur Verfügung? 

Solange also nicht jemand den Schlüssel knacken will, für 
den Geld keine Rolle spielt, dürften die ermittelten Schlüssel 
schon sehrsicher sein. Das Risiko, daß der Schlüssel gestoh- 
len wird, dürfte größer sein, als das, daß der Decodier- aus 
dem öffentlichen Codierschlüssel rekonstruiert wird. 

All jenen, denen die mit diesem Programm ermittelten 
Schlüssel nochnichtsicher genug sind, kann ich nur empfeh- 
len, mit schnelleren Computern größere Schlüssel zu be- 
rechnen. Haben die Primzahlen zwei Dezimalstellen mehr, 
wird für die Überprüfung bereits die zehnfache Zeit benötigt. 
Um den Schlüssel zu knacken, ist die hundertfache Zeit 
notwendig. 
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PD J 154 
Unser seltsamer Verwandter 


Eine Ist Card Anwendung, erstellt von Dipl.-Biologe Dr. Peter Ahnelt, Wien. 





= Ein paar Bilder (z.B. Ist Card lernt selbst 
stellt und bekommen| * Wissen so viel Spaß 
durch Bilder und nun auch noch mit Ton unterlegt ! 


Mit seinem Ist Card hat er eine Fülle von Texten und Bildern, mit Buttons zu 
einem Stammbaum verknüpft - ”in nur einigen Weihnachtsfeiertagen” 
Clipart-Disk) und schon ‚Komplexes per Maus- 
kann's los gehen. Ganz klick, behält es und 
‚ohne Programmierspra-| . |beherrscht es dann für 
er che werden Buttons er- immer, Noch nie hat 
= | Aufgaben zugeteilt. gemacht! 
Doch das ist noch lange nicht alles, was man mit Ist Card machen kann: 
Lehr- und Lernsysteme, Beratungs- und Expertensysteme, Volltext- und 
Hypertextsysteme oder zur Unterstützung von Vorträgen, jeweils angereichert 
g ”Damit ist der programmierten 
C 3/90: Unterweisung ein weites Feld mm 
® gegeben,” 
”Hypertext für einfache Applikationen, Logikkarten für 
——i- ausgefuchste Projekte, da Ist Card gerade durch das 
Logikkartenkonzept alle Trümpfe ausspielen kann.” 
Auch fertige Systeme gibt's bereits, so daß man direkt anfangen kann, 
-in der Bibel oder dem Einigungsvertrag per Volltext-Suche zu stöbern, 


- Mietrechtsprobleme mit dem Expertensystem "Jurex Miete” zu lösen, 
- Hacker zu überführen ($202a StGB ist bereits im Ist Card Paket enthalten). 





LogiLex 


‚Gerhard Oppenhorst, Eifelstr. 32 - 5300 Bonn 1 
Tel.: 0228 / 658346 - FAX: 0228 / 655548 
Unsere Bestseller 1st Card und 1st Lock gibt's im guten Fachhandel oder ab sofort 
auch beim Heim Verlag. Dadurch machen wir uns frei für Weiterentwicklungen, denn 
unsere Produkte leben — gerade auch von Ihren Wünschen. 





BESTELL [efo20u Zeit 
Bitte a Sie mir: __1st Card DM 298,- 
- l. DM 6,- 
HeimVerlag as OMa0ı= 


je] Qv hi k liegt bi 
Heidelberger Landstraße 194 Nachnahme 'errechnungsscheck liegt bei 


6100 Darmstadt 13 None Noto 
Telefon 06151/56057 Syaße, Hausnt. 
Telefax 06151/56059 PLZ, Ort 
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Dietmar Rabich 


Ein Programm unter der Be- 
nutzung von GEM zu schrei- 
ben, istnichtallzuschwer. Der 
höhere Aufwand wird durch 
eine leicht zu bedienende Be- 
nutzeroberfläche entlohnt. Ei- 
nige Grundlagen, die die Pro- 
grammierung erleichtern, sol- 
len hier erörtert werden. Ein 
wenig Kenntnis der GEM-Rou- 
tinen und von deren Namens- 
gebungsolltevorhandensein, 
da nicht alle Routinen erklärt 
werdenkönnen. Trotzdem dürf- 
te es nicht schwerfallen, den 
Erläuterungen zu folgen. 
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EM steht - wie sicher die meisten 
6 wissen - für Graphics Environ- 

ment Manager. Es handelt sich 
um eine Bedieneroberfläche, die ge- 
schaffen wurde, um den Umgang mit 
Computern zu erleichtern. GEM bein- 
haltet die beiden Funktionsblöcke AES 
- Applications Environment Services - 
und VDI - Virtual Device Interface -. Auf 
Wissen um das VDI soll hier nicht vertie- 
fend eingegangen werden, uns liegt hier 
vielmehr die Gestaltung der Program- 
me am Herzen. 

Das AES - eigentlich “die” AES - stellt 
die für den Bediener wichtigen Elemen- 
te wie Fenster, Menüs und Dialoge zur 
Verfügung. Da das AES Graphik-Routi- 
nen benötigt, steht es hierarchisch über 
dem VDI, d.h. es benötigt das VDI. 

Grob verkürzt kann man sagen, daß 
das AESfür das Programmhandling und 
das VDI für die Ein- und Ausgabe (von 
Graphik) zuständig ist. 





GEM-Programme zeichnen sich da- 
durch aus, daß sie unabhängig vom 
Rechner sind. Siesind also so zu halten, 
daß sieohne weiteres auch aufanderen 
Rechnern lauffähig sind. Lediglich eine 
Übersetzung (Compilier-Vorgang) soll- 
te erforderlich sein, um das Programm 
an neue Rechner anzupassen. Eine 
GEM-Programm-Portierung dürfte also 
in wenigen Minuten geschehen sein. 
Hat man lange auf einem speziellen 
Rechner nicht-portabel programmiert, 
könnten zu Beginn einige Schwierigkei- 
ten auftauchen. Aber auf Rechnern wie 
dem COMMODORE 64 ist eine vom 
Rechner unabhängige Programmierung 
nicht vorgesehen, und daher stört es 
auch nicht sehr, wenn im Speicher her- 
umgewühlt wird! Die Umgewöhnung 
lohnt sich aber auf jeden Fall! Fänden 
Sie es denn nicht auch schön, wenn 
sich alle Programme mit einer gewissen 
Einheitlichkeit (nicht Eintönigkeit!!) prä- 
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sentierten und sofort bedienen ließen? 
Ärgert es Sie nicht auch, wenn Sie bei- 
spielsweise lange nach einer Möglich- 
keit suchen müssen, ein Programm be- 
enden zu können? 

Zur unabhängigen Programmierung 
gehört auf dem ST übrigens auch, daß 
die Line A-Routinen und Funktionen 
wie Getrez nicht benutzt werden. Ge- 
trez beispielsweise kann bei einem 
Ganzseiten-Monitor gar keine korrek- 
ten Werte liefern! GEM hingegen stellt 
Funktionen zur Verfügung, die es erlau- 
ben, den Arbeitsbereich korrekt zu er- 
mitteln. Generell müssen rechnerspezi- 
fische Werte abgefragt und nicht ange- 
nommen werden. Es gibt nicht nur Mo- 
nitore mit einer Breite von 640 und einer 
Höhe von 400 Pixeln. Auch liegt der 
Ursprung des Arbeitsbereichs nicht 
immer bei (0,0). Selbst die Buchstaben 
haben nicht immer eine Höhe von 16 
Pixeln! Das AES und das VDI bieten 
reichlich Möglichkeiten, benötigte Wer- 
te abzufragen. 

Aber welche Programmiersprachefin- 
det Verwendung? Eine passende Pro- 
grammiersprache sollte einigen Krite- 
rien genügen. Auf der einen Seite muß 
sie auch auf anderen Rechnern verfüg- 
bar sein, und auf der anderen Seite 
sollte man modularisieren können. 
Strukturierte Datentypen sind sehr hilf- 
reich, da diese bei der Programmierung 
unter GEM immer wieder auftauchen. 
Ein Compiler darf auch nicht fehlen, da 
sonst einige Routinen nicht anwendbar 
sind. Man denke dabei nur an die für 
Accessories notwendige Funktion 
menu_register oder an die Funktion 
appl_find, die auf den korrekten Namen 
des Programms angewiesen ist! 

Esbieten sich also geradezu C, Modu- 
la-2 und Pascal an. Die Priorität liegt 
jedoch eindeutig bei C, denn diese Pro- 
grammiersprache findet man am ehe- 
sten auch auf anderen Rechnern. Es 
kommen jedoch nur die Entwicklungs- 
systeme in Frage, die sich an den gege- 
benen Standard halten. Wenn auf ei- 
nem anderen Rechner unter einem an- 
deren Betriebssystem erst alle Funktio- 
nen umbenannt werden müßten, sowäre 
die Programmierungnichtmehrrechner- 
unabhängig. Abstriche sind jedoch bei 
allen Routinen zumachen, die Betriebs- 
systemfunktionen benötigen, GEM- 
Routinen gehören allerdings nicht dazu. 

Ziel dieses Artikels ist die Entwicklung 
eines Rahmenprogramms, welches 
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Bild 2: Die Dialogbox DESKTOP mit Icon 
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Bild 3: Die Info-Dialogbox 


zeigt, wie man ein Menü auf den Bild- 
schirm bringt und verwaltet. Parallel 
dazu werden Tastendrücke ausgewer- 
tet. Auch das Desktop wird gegen ein 
neues ausgetauscht und das darauf 
befindliche Icon verwaltet. Da das Pro- 
gramm in C geschrieben und sicher 
nicht jede Leserin/ jeder Leser dieser 
Programmiersprache mächtig ist, soll 
zunächst eine Kurzfassung C-spezifi- 
scher Elemente gegeben werden. 

C erfüllt alle oben gegebenen Anfor- 
derungen. Es handelt sich um ein Ent- 
wicklungssystem mit Compiler, dieMo- 
dularisierung ist erlaubt, auch struktu- 
rierte Datentypen existieren. 

Zur C-Syntax: Eine Voranstellung von 
++ bzw. -- steht für die Inkrementierung 
bzw. Dekrementierung vor der Verwen- 
dung eines Variableninhalts. Folglich 
bedeutet-++x nichts anderes alsx=x+1. 
Genauer: Steht in C Proc(++x);, so be- 
deutet das beispielsweise in Pascal: 
x:=Xx+1; Proc(x);. Steht das ++ bzw. -- 
nach der Variablen, wird diese erstnach 


LADEN (Alert) SPEICHER 





der Benutzung verändert, also würde 
statt Proc(x); x:=x+1; inC nur Proc(x++); 
geschrieben. 

Die Symbole +, -, * und / stehen wie in 
anderen Programmiersprachen für die 
vier Grundrechenarten. 

Steht das * direkt vor einem Varia- 
blennamen - etwa ‘a -, bedeutet das, 
daß a auf einen Wert zeigt. Dies ent- 
spricht dem * in Pascal. Die Adresse 
einer Variablen kann man über den 
Adreß-Operator & ermitteln. Wird der 
Adreß-Operator zur Übergabe von Pa- 
rametern an die Routinen benutzt, kann 
der Inhalt der Variablen von der ent- 
sprechenden Routine verändert wer- 
den. 

Die Operatoren >> und << bedeuten, 
daß um eine bestimmte Anzahl Bits 
nach rechts oder links verschoben 
wird. Eine bitweise Verknüpfung und 
wird mit &, eine bitweise Verknüpfung 
oder mit |abgekürzt. Werden die letz- 
ten beiden Symbole doppelt geschrie- 
ben, wird logisch verknüpft. Ein Ver- 
gleich auf Gleichheit erfolgt mit ==. 

Die Berechnung a=a+b kann mita+=b 
abgekürzt werden. Analog klappt das 
natürlich auch mit den anderen Opera- 
toren. 

Und schon wär's geschafft. Beson- 
derheiten von C, die benutzt werden, 
sind aufgezählt. Auch Nicht-C-Program- 
mierer dürften nun mit den Listings kei- 
ne Schwierigkeiten mehr haben. 

Zu einem GEM-Entwicklungssystem 
gehört für vieleauch ein Resource-Con- 
struction-Programm, mit dem man Me- 
nüs, Dialoge und andere GEM-Elemen- 
te kreieren kann. Natürlich ist dieses 
Programm nicht zwingend notwendig, 
es erleichtert die Arbeit jedoch unge- 
mein. Außerdem sieht man gleich, wie 
Dialoge und die anderen Elemente spä- 
ter aussehen werden. 
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Programms 
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Bevor nun die Programmierung be- 
ginnt,legtmannoch einen Planfest, der 
beinhaltet, was das Programm können 
soll und was auf welche Weise realisiert 
werden kann. Bei der eigentlichen Pro- 
grammierung ist es sehr empfehlens- 
wert, rechnerspezifische Routinen in 
einem eigenen Modul unterzubringen. 
Bei einer Portierung reicht es dann, 
dieses Modul den neuen Gegebenhei- 
ten anzupassen. Auch die GEM-Umge- 
bung trennt man besser von den diver- 
sen anderen Routinen. Damit bleibt der 
Überblick gewahrt! 

In einem kurzen Abriß sollen nun noch 
einige AES-Routinen vorgestellt wer- 
den. Logischerweise kann hier nicht 
alles erklärt werden, da eine ausführli- 
che Erklärung viele, viele Seiten füllen 
würde. Eine vollständige Auflistung 
bleibt der Literatur überlassen. 

Das AES besteht aus 11 Bibliotheken. 
Die APPL-Bibliothek enthält die Funk- 
tion appl_init, die zur Anmeldung eines 
GEM-Programms benötigt wird. Der zu- 
rückgegebene Wert gibt Aufschluß dar- 
über, ob eine Anmeldung erfolgreich 
war oder nicht (Rückgabe: -1). War die 
Anmeldung nicht erfolgreich, darf der 
Rest des Programms nicht ausgeführt 
werden. Eine Auswertung des Wertes 
ist demzufolge unabdingbar. (Es gibt 
übrigens viele Programme, die keine 
Auswertung vornehmen. Man verbaut 
sich damit aber die Möglichkeit, daß 
das Programm unter jeder Bedingung 
lauffähig ist.) Ferner gehört in diese Bi- 
bliothek auch die Funktion appl_exit, 
die zum Abmelden des Programms 
benötigt wird. Sie darf nur dann ausge- 
führt werden, wennappi_initerfolgreich 
war. Die Auswertung des Rückgabe- 
wertes scheint zur Zeit auf dem ST 
wenig Sinn zu haben, aber dies scheint 
eben nur so. Sobald ein zukünftiges 
Multitasking-GEM mehrere Programme 
abarbeiten kann, erhält der Rückgabe- 
wert seine Berechtigung. 

Zu der zweiten Bibliothek - der EVNT- 
Bibliothek -gehören Routinen zur Über- 
wachung von Ereignissen. Für jeden 
Ereignistyp gibt es eine eigene Funkti- 
on. Die wichtigste Funktion ist jedoch 
evnt_multi. Sie ermöglicht den Emp- 
fang von verschiedenen Ereignissen. 
Das Beispielprogramm verwendet sie, 
um auf einen Mausklick, einen Tasten- 
druck bzw. eine Menüauswahl zu war- 
ten. Zur genaueren Beschreibung des 
Mausklicks sind die Bits für die betrach- 
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teten Maustasten sowie die Anzahl der 
abzuwartenden Mausklicks zu setzen. 
Die Ermittlung der gedrückten Taste 
erfolgt über einen 16 Bit-Wert. Die obe- 
ren 8 Bits enthalten den Scancode - 
erlauben also die Auswertung der Funk- 
tionstasten - und die unteren 8 Bits den 
ASCII-Code. Wird ein Menüpunkt aus- 
gewählt, erhält das Programm eine 
Nachricht. Diese beinhaltet Menütitel 
und -eintrag. 

Die dritte, die sogenannte MENU-Bi- 
bliothek enthält Routinen zur Menüver- 
waltung. Häufig gebraucht wird 
menu_bar, um eine Menüleiste auf den 
Bildschirm zu bringen und auch wieder 
zu entfernen, und auch menu_tnormal, 
um einen Menütitel zu invertieren bzw. 
die Invertierung aufzuheben. Nach je- 
der Auswahl einer der Optionen in ei- 
nem Drop-Down-Menü bleibt nämlich 
der Titel invertiert. Die normale Darstel- 
lung wird erst durch Aufruf von 
menu_tnormal wieder erreicht. Be- 
nutzt man statt des Menüs die Tastatur, 
wird der entsprechende Menütitel in- 
vertiert, womit wieder die Funktion 
menu_tnormal Verwendung findet. Die 
Invertierung sollte unbedingt vorgenom- 
men werden, damit der Programmbe- 
diener merkt, daß es auch ein Menü 
gibt, in dem das zum Tastendruck ge- 
hörige Kommando zu finden ist. Umge- 
kehrt gehört zu dem passenden Menü- 
eintrag auch ein Tastenkürzel, welches 
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wieder auf die Tastenkombination hin- 
weist. 

Die vierte Bibliothek heißt OBJC- 
Bibliothek und umfaßt Routinen, die 
die Manipulation von Objekten erlau- 
ben. Wichtig sind insbesondere die 
Routinen objc_draw, objc_find und 
objc_offset. Objc_draw erlaubt die Aus- 
gabe von Objekten, also auch von Dia- 
logboxen, objc_find ermöglicht es, an 
einer bestimmten Position - etwa der 
Mausposition - ein dazugehöriges Ob- 
jekt - beispielsweise ein Icon auf dem 
Desktop - zu ermitteln. Objc_offset 
berechnet die Position eines Objektes. 
Wer einen Objektbaum mit objc_add 
erweitern möchte, wird auf einige Pro- 
bleme stoßen, denn der Speicherplatz 
für die Erweiterung muß vorhanden sein! 
Also ist das neue Objekt schon bei der 
Definition des Baums mitaufzunehmen 
oder aber der Baum an einen neuen Ort 
mitausreichendem Speicherplatz zu ko- 
pieren. 

Bibliothek fünf trägt den Namen 
FORM-Bibliothek und enthält die zur 
Verwaltung von Dialogen notwendigen 
Routinen form_do, form_dial, form_- 
center und form_alert. Form_alert ist 
die einfachste darunter. Sie ist dafür 
veranwortlich, daß sogenannte Alert- 
boxen ausgegeben und verwaltet wer- 
den. form_center zentriert ein Objekt 
oder in unserem Fall eine Dialogbox, 
form_dial reserviert den Hintergrund 
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(zum Beispiel die sogenannte Recht- 
eckliste für die Fenster benötigt diese 
Reservierung) und gibt ihn wieder frei. 
Restauriert wird der Hintergrund jedoch 
nicht automatisch! Für das Hintergrund- 
fenster mit der Kennung 0 wird dem 
Programm die Arbeit abgenommen, 
aber nicht für die anderen Fenster. Aber 
keine Sorge: Das Programm erhältrecht- 
zeitig eine Meldung über die EVNT- 
Funktion evnt_mesag bzw. evnt_- 
multi. Form_dial mit dem Parameter 
FMD_FINISH kann übrigens auch dazu 
benutzt werden, um anderen Program- 
men eine “Nachricht” zu schicken, daß 
der Bildschirm zu erneuern ist. 

Die GRAF-Bibliothek - die sechste - 
umfaßt Routinen, die etwa die bewe- 
genden Rechtecke liefern. In dem Bei- 
spielprogramm findet graf_dragbox Ver- 
wendung, um dem Benutzer die Ver- 
schiebung von Icons zu ermöglichen 
und vor allem optisch nahezulegen. 
Außerdem sind hier auch die Routinen 
enthalten, mit denen man die Mausform 
ändern und den Status und die Position 
der Maustasten abfragen kann. 

Die SCRP-Bibliothek trägt die Num- 
mer sieben und beinhaltet die beiden 
Routinen scrp_read und scrp_write, die 
den Pfadnamen für das Scrap-Directory 
lesen bzw. setzen. 

Mit fsel_input aus der Bibliothek FSEL 
- Nummer 8 - wird der bekannte File- 
Selector aufgerufen. Übergeben wer- 
den ein Pfad-beispielsweise 
“ENORDNER\“.TXT” und ein Dateina- 
me “DATEI.TXT”. Zurückgegeben wer- 
den der neue Pfad und der neue Datei- 
name. 

Die umfangreiche neunte Bibliothek 
WIND umschließt alle Routinen zur Ver- 
waltung von Fenstern. Die Routine 
wind_get wird zusammen mit dem Pa- 
rameter WF_WORKYXVWH benutzt, um 
die Ausmaße des Hintergrundfensters 
zu ermitteln, und wind_set in Verbin- 
dung mit WF_NEWDESK, um den neu- 
en Desktop zu setzen. Ferner sperrt 
wind_update den Bildschirmaufbau stö- 
rende Aktionen. 

Die Abfrage der Rechteckliste eines 
Fenster - die Teile eines Fensters, die 
sichtbar sind - geschieht ebenso mit 
wind_get. Übergibt man den Parameter 
WF_FIRSTXYWH, erhält man das erste 
Rechteck dieser Liste und mit 
WF_NEXTXYVVH die weiteren. DasEnde 
derListeist durch ein 0 Pixel breites und 
hohes Rechteck gekennzeichnet. 
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Mitrsrc_load aus der RSRC-Bibliothek, 
sie ist die zehnte, wird ein mit einem 
Resource-Construction-Programman- 
gefertigtes Resource-File geladen. 
rsrc_free gibt den dafür benutzten Spei- 
chervordem Verlassen des Programms 
wieder frei. Die Adressen der einzelnen 
Objekte werden mit rsrc_gaddr ermit- 
telt. 

Die elfte Bibliothek - SHEL - enthält 
eine Routine, mit der man andere Appli- 
kationen starten kann, sowie weitere 
passende Funktionen. Die GEMDOS- 
Funktion Pexec wird dabei nicht be- 
nutzt. Shel_write teilt dem AES mit, daß 
nach Beendigung des laufenden Pro- 
gramms ein anderes zu starten ist. Da- 
mit ist es möglich, zwischen diversen 
Programmen zu wechseln, ohne daß 
dabei mehrere Programme im Speicher 
gehalten werden müssen. 


Doppel-Klick 


auskerten. ., 





Bild 7: Eine der Alertboxen 


Einen Überblick über die AES-Routinen 
hätten wir uns jetzt verschafft. Nunkann 
das Programmieren endlich losgehen. 
Oder doch nicht? 

Erst müssen wir uns noch ein Re- 
source-File verschaffen, welches we- 
nigstens einige notwendig Dinge ent- 
hält. Bild 1 zeigt das Menü, Bild 2 das 
Desktop, Bild 3 die Dialogbox und Bild 
4 die Alertboxen unseres Beispielpro- 
gramms. Richten Sie sich bei dem Ent- 
wurf bitte nach Ihrem persönlichen Re- 
source-Construction-Programm. Die 
Namen der Elemente entnehmen Sie 
bitte den Bildern. Achten Sie aber bei 
der Gestaltung immer auf die bestehen- 
den Konventionen. Zu den Konventio- 
nen aber gleich mehr. 

Ein Resource-Construction-Pro- 
gramm ermöglicht die Gestaltung von 
Menüs, Dialogboxen, Alertboxen, frei- 
en Strings und Icons. Freie Strings und 
Icons sind für das Beispielprogramm 
unerheblich und sollen daher nicht wei- 
ter betrachtet werden. Ebenso sind 
Alertboxen sehr einfach zu erstellen und 
damit recht unwichtig. Menüs und Dia- 
logboxen haben eines gemeinsam: Es 
sind einfache Objektbäume. Ist Ihnen 
etwas aufgefallen? Das Desktop für das 
Beispielprogramm ist nicht aufgeführt! 





Es wirdjedoch auch mit dem Resource- 
Construction-Programm entworfen. Das 
Desktop ist “nur” eine Dialogbox. Exit- 
Buttons existieren natürlich nicht. Sie 
nehmen eine Dialogbox ohne Rahmen 
und plazieren darauf die zukünftigen 
Objekte. Die Größe muß nicht mit der 
Bildschirmgröße übereinstimmen. Es 
würde auch keinen Sinn machen, die 
Bildschirmgröße zu berücksichtigen, da 
diese nicht bekannt sein kann. Das 
Desktop wird nach dem Laden der Re- 
source-Datei den örtlichen Verhältnis- 
sen angepaßt. 

Wenn Sie das Resource-File haben, 
kann die Arbeit beginnen. Zuerst erstel- 
len wir ein Modul mit den systemspezi- 
fischen Routinen. In unserem Beispiel 
handelt es sich lediglich um eine Routi- 
ne, die das Bootlaufwerk ermittelt. Die 
Kenntnis über das Bootlaufwerk wird 
für den Scrap-Pfad benötigt. 

Nunnochein wenig zu den Konventio- 
nen. Im Menü gehören hinter jeden Ein- 
trag, der eine Dialogbox oder ein Fen- 
ster zur Folge hat, drei Punkte, das 
Tastenkürzel gehört an den rechten 
Rand des Eintrags. Im sogenannten 
Desk-Menü findet man einen Eintrag, 
mit dem man eine Programminforma- 
tion abrufen kann. GEM 2.0 setzt statt 
des Menütitels “Desk” automatisch den 
Programmnamenein. Esbietetsichalso 
geradezu an, dies unter dem aktuellen 
ST-GEM nachzuahmen und den Pro- 
grammnamen anstelle von “Desk” ein- 
zusetzen. Allerdings muß dies schon 
bei dem Entwurf des Menüs gesche- 
hen. Unter der aktuellen GEM-Version 
aufdemST findetman im zweiten 
Menü von links die Dateioperationen 
und auch den Eintrag, mit dem das 
Programm beendet werden kann. 

Menüeinträge, dienicht selektiert wer- 
den können oder dürfen, stellt man ge- 
sperrt dar. Beispielsweise hat das Spei- 
chern eines Textes wenig Sinn, wenn 
gar kein Textfenster geöffnet ist. Auch 
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Bild 8: Ein heruntergeklapptes Menü 


hates wenig Sinn, extrafür Accessories 
ein anderes Menü auf den Bildschirm zu 
bringen, da Accessories ein Zubehör 
zum laufenden Programm und nicht 
getrennt laufende Applikationen sind. 
Achten Sie auch immer darauf, daß 
Accessories wie zum Beispiel das Kon- 
trollfeld Fenster öffnen können und da- 
her verschiebbar sein müssen. Nehmen 
wir hierzu ein (Negativ-)Beispiel. Einige 
Programme lassen zu, daß Accessories 
aufgerufen werden. FürGEM-Program- 
me ist das natürlich selbstverständlich. 
Ruft man nun das Kontrollfeld auf und 
verschiebt es, wird von dem Programm 
der komplette Bildschirm neu gezeich- 
net. Das Kontrollfeld ist zwar nach wie 
vor geöffnet, aber zu sehen ist es nicht 
mehr. 

Vom Benutzer einstellbare Werte wie 
Icon-Positionen werden in einer Datei 
mit der Extension INF abgespeichert. 
Der Name dieser Datei ist mit dem des 
Programms identisch. In unserem Fall 
heißt das Programm GEMPROG und 
damit die Programmdatei GEMPROG.- 
PRG, die Parameterdatei hieße dann 
GEMPROG.INF. Die Resourcedatei 
trägt übrigens immer die Extension RSC, 
also heißt sie hier GEMPROG.RSC. 

In den Dialogboxen sollten die But- 
tons oder Felder zum Verlassen der 
Dialogbox immer an ähnlichen.Stellen - 
beispielsweise nur am unteren Rand - 
zu finden sein und sich klar vom restli- 
chen Inhalt abheben. Es ist sehr lästig, 
wenn man erst verschiedene Elemente 
anklicken muß, um einen Dialog zu be- 
enden. 

Die Mausform ist in der Regel ein Zei- 
ger. Für den Fall, daß das Programm 
etwas mehr Zeit benötigt, ist die Form 
einer Biene zu wählen. Wird ein Objekt 
bewegt, erscheint die Maus (nicht der 
kleine graue Kasten!) in Form einer fla- 
chen Hand. Um eine Sache zu dimen- 
sionieren - beispielsweise ein Fenster - 
‚ wird die Hand mit dem Zeigefinger 
benutzt, und bei Texteingaben findet 
der Balken Verwendung. 

Generell ist innerhalb des Programms 
auf innere Konsistenz zu achten. Es 
dürfen nicht ähnliche Dinge auf ver- 
schiedene Arten bedient werden kön- 
nen. Damit ist natürlich nicht gemeint, 
daß nicht parallel zum Menü auch die 
Tastatur bedient werden darf, sondern 
vielmehr, daß beispielsweise Buttons in 
Dialogboxen mal oben und mal unten 
plaziert werden. 
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Bei der Programmierung sollte ferner 
noch auf ein paar andere Dinge geach- 
tet werden. Ein gelegentlicher evnt_- 
timer-Aufruf bei längeren Operationen 
gewährleistet, daß auch andere Appli- 
kationen weiterarbeiten können. Der 
Dreifachklick für diverse Aktionen ist 
ein Kunststück für den Zeigefinger, also 
bleibt man beim Einfach- oder Doppel- 
klick. Ein Icon für die Scrap-Ablage sieht 
gut aus und hat seine Berechtigung. Es 
kann Information darüber geben, ob 
Dateien in der Scrap-Ablage bereitlie- 
gen. Bei der Textausgabe über die VDI- 
Funktionen erreicht man einen schnel- 
leren Bildschirmaufbau, wenn der Text 
auf einer Byte- oder noch besser einer 
Word-Grenze beginnt. Der Wiederauf- 
bau eines Textfensterläuftschnellerab, 
wenn kein Clipping durchgeführt wer- 


mit Fenstern - einwandfrei? Kommt es 
nicht zu Abstürzen unter anderen Hard- 
ware-Bedingungen? Und so fort. Te- 
sten Sie Programme nicht alleine, las- 
sen Sie auch Laien an das Programm! 
Soviel zum Testen. 

Das Beispielprogramm zeigt uns, wie 
man sich ein Grundgerüst für ein GEM- 
Programm verschaffen kann. Das Rah- 
menprogramm ist in der Lage. einen 
eigenen Desktop (mit einem Icon) anzu- 
melden, ein Menü darzustellen und na- 
türlich auch, den Desktop und das Menü 
zu verwalten. Unser Desktop beinhaltet 
lediglich ein Icon, damit das Prinzip der 
Programmierung klar wird. Möchte man 
jedoch mehrere Icons haben, so müs- 
sen diese entweder vorher (beim Ent- 
wurf mit dem Resource-Construction- 
Programm) deklariert werden oder der 
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Bild 9: Im Beispielprogramm benutzte AES-Funktionen 


den muß. Stattdessen berechnet man 
den Platz für den Text und gibt nur 
entsprechend vvielaus. Iconslassensich 
frei auf dem Desktop plazieren. Für den 
Benutzeristesjedoch praktischer, wenn 
sie sich nur innerhalb eines Raster po- 
sitionieren lassen. Beispielsweise könn- 
ten die Icon-Positionen auf Byte-Gren- 
ze festgelegt werden. 

Ist ein Programm fertig, beginnt die 
Testphase. Zu einem umfangreicheren 
Test gehört auch ein Probelauf auf ei- 
nem Farb- und einem Monochrommo- 
nitor. Auch die Darstellung auf einem 
Ganzseitenmonitor durch Grafikkarten 
sollte dazugehören. 

Stellen Sie sich einen Fragenkatalog 
zum Testen: Laufen Accessories - auch 


Objekt-Baum (ein Array von Objekten, 
die miteinander verknüpft sind) muß 
erweitert werden. Die Erweiterung schei- 
tert jedoch daran, daß ein Feld nicht so 
einfach vergrößert werden kann. Also 
muß der gesamte Objekt-Baum (das 
Array, nicht jedoch Texte etc.) an eine 
andere Stelle kopiert werden, die genü- 
gend Platz bietet. 

Sollen eigene Dinge auf das Desktop 
gebracht werden, so darf dies niemals 
direkt geschehen. Werden Ausgaben 
direkt auf das Desktop gemacht und 
wird danach darüber ein Fenster ge- 
bracht, so ist die Ausgabe verschwun- 
den, wenn das Fenster geschlossen 
wird. Für die eigenen Ausgaben findet 
die Application-Block-Struktur (USER- 
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BLK)Verwendung. Somiterhältdas Pro- 
gramm immer dann eine Meldung 
(über USERBLK), wenn das Desktop 
zu erneuern ist. Das Menü sollte immer 
die Menüeinträge sperren, die nicht 
anwählbar sein sollen. Dies geschieht 
mit menu_ieanble, indem die Adresse 
des Menüs, die Nummer des Eintrags 
und eine 0 (für desaktivieren) oder eine 
1 (für aktivieren) übergeben wird. Das 
Beispielprogramm macht das nicht, da 
gar keine Lade- oder Speicher-Routi- 
nen implementiert wurden. Das Tasten- 
kürzel steht jeweils am rechten Rand 
des Menüeintrags. Das entsprechende 
Tastaturereignis wird von dem Beispiel- 
programm ausgewertet. Soll das Pro- 
gramm noch unabhängiger gestaltet 
werden, so besteht die Möglichkeit, den 
Text des Menüeintrags nach Programm- 
start zu untersuchen. Dazu wird der 
Menü-Objektbaum nach den betreffen- 
den Einträgen abgesucht und das Ta- 
stenkürzelausgewertet. Somitwirdauch 
bei einer Veränderung des Resource- 
Files der Tastaturaufruf geändert. Das 
Bild 5 zeigt das Beispiel-Programm in 
Aktion. Eine Alertbox ist auf Bild 6 zu 
sehen und auf Bild 7 eines der beiden 
Drop-Down-Menüs. 

Wenden wir uns nun dem Programm 
zu. 

Im Listing befinden sich zahlreiche 
Erklärungen zu den einzelnen Schritten, 
weshalb diese hier nicht ausführlich er- 
klärt werden sollen. Das Hauptpro- 
gramm main ist für den groben Rahmen 
zuständig. Dazu gehört die Initialisie- 
rung init_prg und das Abmelden 
exit_prg. In der while-Schleife wird so- 
lange gewartet, bis die Variable finish 
den Wert TRUE erhält. Für den Fall, daß 
ein Menüeintrag angeklickt wurde, wird 
die Routine hale_menu aufgerufen, bei 
einem Mausklick hale_mouse und bei 
einem Tastaturereignis hale_key. Die 
Initialisierungsroutine init_prg meldet 
das Programm zuerst beim AES an, 
stellt dann die Maus als Biene dar, weil 
diefolgenden Aktionen doch etwas mehr 
Zeit erfordern. Dann wird das Resour- 
ce-File geladen und ausgewertet. Di- 
rekt nach der Auswertung wird das 
Desktop in der Größe angepaßt und 
ausgegeben. Dann wird der Scrap-Pfad 
gesetzt, falls er noch nicht existiert. 
Schließlich erfolgt die Ausgabe des 
Menüs und die Maus wird wieder ein 
Pfeil. Eine Parameterdatei könnten die- 
ser Routine auch eingelesen und aus- 
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gewertet werden. Die Routine exit_prg 
ist vergleichsweise kurz. Sie meldet das 
Menü und das Desktop ab, gibt den 
Resource-Speicher wieder frei und 
meldet das Programm ab. 

Halle_menu ist wohl die einfachste 
unter den Handle-Routinen. Entspre- 
chend dem Menüeintrag wird eine Ak- 
tion durchgeführt und schließlich der 
Menütitel wieder normal dargestellt. Die 
normale Darstellung ist übrigens späte- 
stens dann zu wählen, wenn das Menü 
wieder verfügbar ist. Der Menütitel soll- 
te solange invertiert bleiben, wie die 
“blockierende” Aktion andauert. Wird 
also beispielsweise eine Datei geladen, 
so hebt man die Invertierung auf, so- 
bald diese geladen ist. Von hale_menu 
aus wird auch die Informationsdialog- 
box über do_info aufgerufen. In do_info 
wird ein vollständiger Dialog durchge- 
führt. 

Ruft ein Programm mehrere Dialog- 
boxen auf, so empfiehlt es sich, den 
Vor- und den Nachbereitungsteil in ge- 
trennten Funktionen zu deklarieren, 
denn diese unterscheiden sich in der 
Regelnicht. Der Durchführungsteilkann 
sich erheblich unterscheiden, beispiels- 
weise können wie bei einem Filese- 
lector Dateinamen gescrolltwerden. Die 
dritte Handle-Routine - hale_key - ist 
schon etwas komplizierter. Dort wer- 
den nicht nur die oberen 8 Bit des Ta- 
stencodes ausgewertet, sondern es 
wird auch entsprechend der gedrück- 
ten Taste der Menütitel invertiert und 
dann wieder normal dargestellt. 

Die Handle-Routine hale_mouse er- 
mittelt zuerst das Objekt, welches sich 
ander Mausposition befindet. Dann wird 
zwischen einem Doppel- undeinemEin- 
fachklick unterschieden. Beieinem Dop- 
pelklick wird das entsprechende Icon 
invertiert, eine Alertbox ausgegeben und 
danach die Invertierung wieder aufge- 
hoben. Wurde nur einmal geklickt, ist 
noch zu unterscheiden, ob die Mausta- 
ste mittlerweile losgelassen wurde oder 
nicht. Ist die linke Maustaste noch ge- 
drückt, wird das Icon bewegt. Ist sie 
nicht gedrückt, wird das Icon invertiert, 
wenn sich der Mauszeiger darüber be- 
findet, bzw. die Invertierung aufgeho- 
ben, wenn außerhalb des Icons geklickt 
wurde. 

In der Maus-Handling-Routine wer- 
den zwei neue Routinen aufgerufen. 
Dies ist zum einen eine Ausgabe-Routi- 
ne und zum anderen eine Routine, die 


die Icon-Bewegung übernimmt. Die 
Ausgabe-Routine draw_objc gibt ein 
Objekt unter Berücksichtigung der 
Rechteckliste aus. Dies ist notwendig, 
da nicht immer ein komplettes Objekt 
neu gezeichnet werden muß. Denken 
Sie nur daran, wenn ein Fenster ein Icon 
halb überdeckt! 

Move_objc versteckt zuerst das Ob- 
jekt und gibt es über draw2_objc aus. 
Die zweite Ausgabe-Routine ist erfor- 
derlich, da mit HIDETREE versteckte 
Objekte nicht direktangesprochen wer- 
den können. Dann wird der Arbeitsbe- 
reich - der Bereich, in dem das Objekt 
bewegt werden darf- ermittelt, die Maus 
als flache Hand dargestellt und das 
Objekt via graf_dragbox verschoben. 
Anschließend stehen die neuen Koordi- 
naten des Icons fest. Wenn man nur 
bestimmte Positionen zuläßt, so ist an 
dieser StelleeineAnpassung - beispiels- 
weise auf Byte-Grenze - vorzunehmen. 
Letztendlich wird die Maus wieder als 
Pfeil dargestellt und das Icon ausgege- 
ben. Damit seien die Erklärungen been- 
det. Im Listing finden sich noch weitere 
Erklärungen und Anregungen. Ich hof- 
fe, daß Ihnen die kleine Einführung in 
die Benutzung des GEM gefallen hat 
undsieals nächstes Programm ein wun- 
derschönes GEM-Programm schreiben 
werden. 


Literatur: 


[1] Atari ST Profibuch, H.-D. Jan- 
kowski/ J. F. Reschke/ D. Rabich, 
Sybex 

[2] GEM Programmier-Handbuch, P. 
Balma/ W. Fitler, Sybex 

[3] Professionel GEM, T. Oren, ANTIC 
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TOS Expansions Card 

ist eine Eigenentwicklung aus dem 
Hause Hard & Soft, die es ermög- 
licht, in jeden Atari ST Computer 
das Betriebssystem TOS 2.06 ein- 


zubauen. 


Die Idee für die Karte entstand da- 
durch, daß uns keiner der bisher an- 
gebotenen kommerziellen lösungs- 
ansätze, sowie lösungsvorschläge 
aus Zeitschriften, überzeugen konnte. 


Wir haben daher eine Erweite- 
rungskarte entwickelt, welche alle 
bisher angebotenen Hardwarelö- 
sungen in den Schatten stellt. 


Die TOS Expansions Card ist auch 


als Leerkarte ohne TOS 2.06 erhält- 
lich. 


Hard&Soft 





Leistungsdaten 

— besonders einfacher und platz- 
sparender Einbau 

— Umschaltmöglichkeit zwischen 
bestehendem Betriebssystem 
und TOS 2.06, auch bei Rech- 
nern mit 6 Betriebsbausteinen 
ohne leiterbahnen zu durch- 
trennen, über den mitgelieferten 
Schalter 

— keine unprofessionellen Flach- 
bandverbindungen, dadurch 
störungsunanfällig 

— Platine sitzt fest im Rahmen 

— wird einfach auf die CPU auf- 
gelötet. Wenn sich bereits ein 
MS DOS Emulator oder eine 
16 MHz Erweiterung auf der 
CPU befinden, wird die TOS 
EXPANSIONS CARD einfach 
dazwischen gesteckt, was 





HushI-Kontralle 





aufgrund der geringen Bauhöhe 
von ca. ö mm ganz einfach 
möglich ist 
— HD-Interface werden unterstützt 
— HD-Formatierroutine im Desktop 
vorhanden 


Preise 


TOS EXPANSIONS CARD 
incl. orig. TOS 2.06 


DM 198,— 


dto. ohne TOS 2.06 


DM 79, — 





Hard & Soft A. Herberg 
Obere Münsterstraße 33-35 


4260 Castrop-Rauxel 


Tel. 02305/18014 
02305/18015 


Fax 02305/32463 


DESK_ DATEI INDEX 


Andreas Lötscher/tw 





Eines der wichtigsten Werk- 
zeuge, die eine grafische Be- 
nutzeroberfläche wie GEM 
dem Benutzer zur Verfügung 
stellt, ist eine Fensterver- 
waltung. Sie ermöglicht dem 
Anwender, gleichzeitig meh- 
rere Dinge auf einem einzigen 
Bildschirm zu tun - so zum 
Beispiel drei verschiedene 
Texte zur selben Zeit zu schrei- 
ben. Für diese Freiheit muß 
aber (wie üblich) der Program- 
mierer zahlen. Er sieht sich 
gezwungen, sein Programm 
auf eine wesentlich kom- 
plexere Art mit der Umgebung 
kommunizieren zu lassen. 
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GRUNDLAGEN 


er folgende Artikel soll dazu die- 
D nen, sowohl dem Einsteiger die 

grundlegenden Routinen vorzu 
stellen, als auch fortgeschrittenen Pro- 
fis wertvolle Tips und Tricks zu vermit- 
teln. Nach Lektüre des Artikels werden 
Sie wissen, wie man einen komforta- 
blen und flexiblen Window-Manager 
erzeugen kann, der das leidige Pro- 
grammieren von Windows in eigenen 
Programmen vereinfacht (auf den Dis- 
ketten zum Heft befinden sich die Rou- 
tinen zum Window-Manager). 


Vorarbeit 


Bevor wir in unserem Programm auf 
dem Bildschirm ein wunderschönes 
Window erblicken, müssen wir einiges 
am Vorarbeit leisten. Nach der Anmel- 
dung beim AES (Application Environ- 
ment System des GEM) und GEM [sie- 
hegem_init() im Window-Manager] wird 


HMOVER 


CLOSER 
Y 





mit wind_create() ein Fenster verein- 
bart: 


w_handle = 
wind_create()(kind, wx, wy, ww, wh); 


Als Parameter benötigt die Routine die 
x-/y-Koordinaten,die Weite (ww; Brei- 
te) und Höhe (wh) des Fensters in der 
maximalen Größe (meistens ganzer 
Desktop ohne Menüleiste, weiteres sie- 
he unten). 

Außerdem die Komponenten desFen- 
sters (kind), die vorhanden sein sollen. 
Sie umfassen: Titelbalken, Infozeile, 
Schließecke, Volle-Größe-Box, Bewe- 
gungs-Box, Pfeil nach oben, Pfeil nach 
unten, vertikaler Schieber, Pfeil nach 
links, Pfeil nach rechts, horizontaler 
Schieber (vgl. Tabelle 1 und Bild 1). Der 
Parameter kind besteht aus einer ODER- 
Verknüpfung aller anzuzeigenden Fen- 


FULLER 
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Bild 1: Die 
Elemente eines 


SIZER Fensters 


sterelemente. Wenn ein Element nicht 
angegeben wird, kann das Programm 
auch keine Meldung über die Anwahl 
dieses Elementes bekommen, da es ja 
nicht auf dem Bildschirm erscheint. 
Wenn also z.B. der Verschiebebalken 
nicht genannt wird, kann der Benutzer 
das Fenster nicht verschieben, und das 
Programm erhält nie eine Meldung vom 
Event-Manager (genaueres folgt spä- 
ter). 

Als Rückgabewert erhält man die Iden- 
tifikationsnummer des Fensters (w_- 
handle), über die wir im folgenden das 
Fenster ansprechen können. Sie wird 
vom AES vergeben, um mehrere Fen- 
ster auf dem Bildschirm unterscheiden 
zu können. 

Nachdem GEM nun weiß, wie unser 
Fenster auszusehen hat und welche 
Maximalgröße es besitzt, können wir es 
mit dem folgenden Befehl auf dem Bild- 
schirm darstellen: 


error = 
wind_open (w_handle, wx, wy, ww, wh); 


Eingabeparameter sind die oben vom 
AES vergebene Fensternummer (w_- 
handle) sowie die Fenstergröße (wx, wy, 
ww, wh), in der es auf dem Bildschirm 
dargestellt werden soll. 

Der Rückgabewert error ist gleich 0, 
wenn ein Fehler aufgetreten ist. 

Haben Sie bei der Erzeugung eines 
Fensters durch wind_create() angege- 
ben, daß das Fenster eine Titel- oder 
Infozeile oder einen Schieber (Slider) 
hat, müssen Sie diese vor dem Aufruf 
von wind_open() setzen, da sonst un- 
vorhergesehene Wirkungen auftreten 
können. Dazu dient die Routine 
wind_set(): 


NAME 0x0001 
CLOSER 0x0002 
FULLER 0x0004 
MOVER 0x0008 
INFO 0x0010 
SIZER 0x0020 
UPARROW 0x0040 
DNARROW 0x0080 
VSLIDE 0x0100 
LFARROW 0x0200 
RTARROW 0x0400 


HSLIDE 0x0800 


Tabelle 1: Namen und (hexadezimale) Werte 
der Fensterelemente 
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Bild 3: Rechteckliste von zwei Fenstern und neuzuzeichnender Bereich bei Überlagerung durch 


eine Dialogbox 


error = wind_set(w_handle, w_field, w1, 
w2, w3, w4); 


Wie bei allen Routinen, die Fenster be- 
arbeiten, so muß auch hier die Fenster- 
nummer (w_handle) angegeben wer- 
den. Der nächste Parameter (w_fiela) 
legt fest, welche Fensterelemente ver- 
ändert werden sollen. Die letzten vier 
Parameter variieren, je nachdem wel- 
che Funktion ausgewählt wurde [siehe 
Tabelle 2; nur die mit ‘set’ gekennzeich- 
neten Funktionen können mit wind_set() 
verwendet werden]. Auch hier ist der 
Rückgabewert (error) 0 bei einem Feh- 
ler. 

Um den Fensternamen zu setzen, ver- 
wenden wir WF_NAME und geben in 
w1 und w2 die oberen bzw. die unteren 
16 Bits der Adresse an, an der sich 
unser Namens-String befindet (in Pure 
C genügt die Angabe der Adresse; sie 
muß nicht in einen Low- und High-Teil 
getrennt werden). Der Aufruf sieht dann 
folgendermaßen aus: 


error = wind_set(w_handle, WF_NAME, 
name, 0, 0); 


Endlich steht unser Fenster auf dem 
Bildschirm, doch leider noch nicht ganz 
perfekt, denn nur der Rahmen wurde 
gezeichnet, während die sogenannte 
Arbeitsfläche (Inneres des Fenster) nicht 
berührt wurde. Wir sollten diese also 
noch weiß (oder mit anderem Inhalt) 
füllen. Um die Koordinaten der Arbeits- 
fläche zu ermitteln, verwenden wir 
wind_get{(): 


error = wind_get(w_handle, w_field, w1, w2, 
w3, w4); 


Diese Prozedur ist wind_set() ähnlich, 
verändert aber keine Window-Daten, 
sondern liefert uns die aktuellen Werte 
(siehe Tabelle 2). Für die Koordinaten 
des Arbeitsbereiches setzen wir w_field 
auf WF_WORKXYWH und erhalten in 
w1,w2, w3, w4 die gesuchten Werte (x/ 
y-Koordinaten sowie Breite und Höhe): 


error=wind_get( w_handle, 
WF_WORKXYWH, x, y, w, h); 


Um innerhalb des Fensters etwas aus- 
geben zu können (Text oder Grafik), 
müssen wir dafür sorgen, daß während 
der Ausgabe keine anderen Routinen 
innerhalb dieses Bereich tätig werden. 
Dazu schalten wir am Besten erst ein- 
mal den Grafik-Cursor ab: 


v_hide_c(handle); 


handle ist hier übrigens nicht die Fen- 
sternummer, sondern die Nummer der 
physikalischen Workstation, die inner- 
halb der gem_init(-Routine vom Aufruf 
graf_handle() geliefert wird. 

Als zweites setzen wir die Farbe für 
den Fenster(innen)hintergrund: 


vsf_color(handle, color); 
handle ist wieder die Nummer der physi- 
kalischen Workstation. colorist der Farb- 


index (0 und 1 sind immer Verfügbar, 
weitere hängen vom Ausgabegerät ab). 
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Außerdem müssen wir den Bereich, in- 
nerhalb dessen wir etwas ausgaben, 
auf das Fensterinnere beschränken. Die 
Koordinaten dazu haben wir mittels 
wind_get() weiter oben bereits ermittelt; 
allerdings benötigen wir zwei x/y-Koor- 
dinaten, so daß wir noch eine kurze 
Umrechnung vornehmen müssen: 


x2=xX+w-1; 
y2=y+b-1; 


Nun verwenden wir für die beiden x/y- 
Paare ein Array und können mit der 
vs_clip()-Funktion die Ausgabe auf den 
Festerbereich beschränken (clippen): 


vs_clip(handle, 1, xyarray); 


Mit der v_bar()-Routine zeichnen wir 
nun ein weißes Rechteck: 


v_bar(handle, xyarray); 


Nach dem Zeichnen sollte man nicht ver- 
gessen, das Clipping auszuschalten: 


vs_clip(handle, 0, xyarray); 


und den Grafik-Cursor wieder einzu- 
schalten: 


v_show_c(handle); 


Nun haben wir ein Fenster mit weißem 
Inhalt und können in ihm weitere Aus- 
gaben tätigen. Zum Beispiel einen Text 
mittels der Funktion v_justified() ausge- 
ben oder grafische Elemente zeichnen. 
Ihrer Fantasie bzw. Ihren Anwendun- 
gen sind keine Grenzen gesetzt. Alle 
dazu notwendigen Routinen finden Sie 
innerhalb des VDI. Beachten Sie, daß 
Sie, soweit dies nicht bereits durch 
Routinen des Window-Managers ge- 
schehen ist, bei Ausgaben das Clipping 
einschalten sollten. 


Programmende 


Am Ende eines GEM-Programms müs- 
sen alle geöffneten Fenster wieder ge- 
schlossen werden. Dies erledigt, im 
Gegensatz zum Öffnen, eine einzige 
Routine (jeweilsfür jedes geöffnete Fen- 
ster einzeln): 


error = wind_close(w_handle); 


Hierbei ist dann die Fensternummer 
wieder der Eingangsparameter, und ein 
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WF_KIND 
WF_NAME 


WF_INFO 
WF_WORKXYWH 


WF_CURRXYWH 
WF_PREVXYWH 


WF_FULLXYWH 


WF_HSLIDE 
WF_VSLIDE 


WF_TOP 


WF_FIRSTXYWH 


WF_NEXTXYWH 


WF_RESVD 
WF_NEWDESK 


WF_HSLSIZE 
WF_VSLSIZE 


WF_SCREEN 





10 


11 


12 


13 
14 


15 


16 


TR 


ab Atari-GEM 3.0 (TT): 


WF_COLOR 


W_BOX 
W_TITLE 
W_CLOSER 
W_NAME 
W_FULLER 
W_INFO 
W_DATA 
W_WORK 
W_SIZER 
W_VBAR 
W_UPARROW 
W_DNARROW 
W_VSLIDE 
W_VELEV 
W_HBAR 
W_LFARROW 
W_RTARROW 
W_HSLIDE 
W_HELEV 
WF_DCOLOR 


18 


oSnSouUPrwm-o 


19 





set 
set 


set 
get 


set/get 
get 


get 


set/get 
set/get 


set/get 


get 


get 


reserviert 


set 


set/get 


set/get 


get 


set 


set 


Fensternamen setzen (Zeiger auf Text in 
w1, w2) 

Info-Zeile setzen(Zeiger auf Text in w1, w2) 
Arbeitsbereich des Fensters (w1: x-, w2: y- 
Position, w3: Breite, w4: Höhe) 
Fenstergröße (w1: x-, w2: y-Position, w3: 
Breite, w4: Höhe) 

Größe des vorherigen Fensters (w1:x-, w2: 
y-Position, w3: Breite, w4: Höhe) 
Fenstergröße in größtmöglicher Ausdeh- 
nung (w1: x-, w2: y-Position, w3: Breite, d: 
Höhe) 

Position für horizontalen Schieber (w1: 0: 
links, 1000: rechts) 

Position für vertikalen Schieber (w1:0: oben, 
1000: unten) 

set: Fenster wird aktuelles (oberstes) Fenster 
get: liefert Nummer des aktuellen Fensters 
(w1: handle) 

Koordinaten desersten Rechtecksin Recht- 
eckliste des Fensters (w1: x-, w2: y-Positi- 
on, w3: Breite, w4: Höhe) 

Koordinaten des nächsten Rechtecks in 
Rechteckliste des Fensters (w1: x-, w2: 
y-Position, w3: Breite, w4: Höhe) 


neues Desktop setzen (w1: (High) und w2 
(Low): Adresse des Objektbaums (ein Null- 
zeiger setzt GEM-Desktop), w3: Objekt 
nummer des ersten darzustellenden Objekts) 
relative Größe des horizontalen Schiebers 
(w1: 1-1000; -1: Minimalgröße) 

relative Größe des vertikalen Schiebers (w1: 
1-1000; -1: Minimalgröße) 

Adresse (w1: High-Word, w2: Low-Word) 
und Länge (w3: High-Word, w4: Low-Word) 
des internen Puffers zum Zwischenspei- 
chern des Hintergrunds bei Drop-Down- 
Menüs und Alert-Boxen 


Farben der Fensterelemente (w1: Element, 
w2: Farbe für ‘Fenster aktiv’, w3: Farbe für 
‘Fenster inaktiv’) 

Fensterelemente (Werte für a): 
Fensterhintergrund 

Titelbox 

Schließbox 

Namenszeile 

Volle-Größe-Box 

Infozeile 

restliche Elemente 

Arbeitsbereich 
Größenveränderungsbox 

Elemente des vertikalen Balkens 

Pfeil nach oben 

Pfeil nach unten 

Hintergrund für vertikalen Schieber 
vertikaler Schieber 

Elemente des horizontalen Balkens 
Pfeil nach links 

Pfeil nach rechts 

Hintergrund für horizontalen Schieber 
horizontaler Schieber 

Standardfarben für Fensterelemente 





Tabelle 2: Funktionen für wind_get() und wind_set() 
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Construction 


Application System 


Das ACS (Application Construction System) ist 
ein neuartiges Entwicklungs-Tool für ATARIST(E) 
und TT. Mit ACS sind vollständige GEM-Pro- 
gramme in kürzester Zeit erstellbar. 


10 Minuten für ein einfaches 
GEM-Programm mit Fenstern 


Sie können sich voll auf Ihre Anwendung konzen- 
trieren. Sie definieren lediglich, welche Routinen 
bei Anwahl von grafischen Objekten wie z.B. 
Icons, Knöpfen oder Menüpunkten auszuführen 
sind. Lästige Programmieraufgaben wie Neu- 
zeichnen der Fenster, Ziehoperationen, Dialoge 
und Menüs in Fenstern entfallen; das alles erle- 
digt ACS für Sie! 


Programmieren nach dem 
Baukastenprinzip 


MAXON Computer GmbH «® Schwalbacher Str. 52 « 6236 Eschborn ® Tel.: 


EASY RIDER Reassembler 138,- 
- EASY RIDER m. Assemb. 198,- 
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Grafikkarte M128 DM 698,- 


19” Mono-Monitor + M128 Karte 
MSM110, 1280x960, 68 Hz DM 2398,- 


19” GS-Monitor + M128 Karte 
GSM128, 1280x960, 72 Hz DM 2698,- 


Die S/W-Zukunft heißt »Graustufen«. 
Der 19” Graustufenmonitor kann direkt 
am TT in 1280x960 mono oder mit 
Grafikkarte in 256 Graustufen betrieben 
werden. Die Auto-Umschaltung von 
Mono auf GS und das Spezialkabel für 
den zusätzlichen Anschluß eines VGA 
Farbmonitors am TT ist Standard. 


Monitor GS128/TT DM 2490,— 
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Auf der CeBIT lüften wir das 
Geheimnis der innovativsten 
WEIPGEIEILTEICH 


BERESN 
a. 


... schnell wird sie sein, 
verdammt schnell. 


... der Preis? Warten Sie’s ab! 





Besuchen Sie uns auf der CeBIT '92 
vom 11. bis 18. März 1992 in Halle 7 
auf dem ATARI-Stand 046. Oder kaufen 
Sie schon jetzt zu den neuen, niedrige- 
ren Preisen. Rufen Sie uns einfach an. 





DER APPLICATION- 
BUILDER FÜR DEN 
ATARI ST/TT 


ACS besteht aus einem komfortablen Editor und 
einer zulinkbaren Bibliothek. Die erzeugten Pro- 
gramme, auch der Editor, sind durch einfaches 
Umbenennen als Accessory lauffähig. Der 
Editor beinhaltet die volle Funktionalität eines 
RCS einschließlich Icon- und Image-Editor 
u.v.m. Vorhandene RSC-Dateien können wei- 
terverarbeitet werden. 
ACS macht da weiter, wo 
ein RCS aufhört! 

ACS arbeitet derzeit 
mit Pure C und Turbo GC 
zusammen. Weitere C- 
Compilerund andere Pro- 
grammiersprachen wie 
z.B. MAXON Pascal sind 
in Vorbereitung. 


DM 193,- 


Unverbindl. Preisempfehlung 
Auslandsbestellungen nur gegen 
Vorauskasse 
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Fehler wird mit der Rückgabe einer 0 
angezeigt. 

Damit ist unser Fenster vom Bildschirm 
verschwunden, existiert für GEM aber 
noch und kann jederzeit wieder mittels 
wind_open() geöffnet werden! Um es 
aus der GEM-Liste zu löschen, benöti- 
gen wir einen weiteren Aufruf: 


error = wind_delete(w_handle); 


Jetzt ist es endgültig begraben, seine 
Identifikationsnummer kann von GEM 
für ein anderes Fenster verwendet wer- 
den, und wir können, nach Abmeldung 
beim GEM [im Manager die Funktion 
gem_exit()], das Programm beenden. 

Würden wir mit den bisher vorgestell- 
ten Routinen ein Fenster öffnen, würde 
dies zwar auf dem Desktop (mit Inhalt) 
erscheinen, hätte aber einen gravieren- 
de Mangel: man könnte zwar mit der 
Maus versuchen, die Größe oder Lage 
zu verändern, es zu schließen oder den 
Inhalt zu scrollen, nur würde unser 
Fenster stur auf dem ursprünglichen 
Platz in seiner Eröffnungsgröße verhar- 
ren. Wir benötigen also weitere Routi- 
nen zur Fenstermanipulation. 


Let’s go ... 


GEM-AES nimmt uns für unser Vorha- 
ben eine Menge Arbeit ab. Wir brau- 
chen uns um nichts weiter zukümmern, 
als die gewünschten Parameter beim 
Öffnen eines Fensters richtig zu setzen 
und dann auf eine Meldung des GEM zu 
warten, die uns mitteilt, was der Benut- 
zer mit unserem Fenster anstellen möch- 
te, und gleich auch noch die entspre- 
chenden Werte liefert. 

Nachdem wir ein Fenster auf den Bild- 
schirm gebracht haben, warten wir, d.h. 
unser Programm, darauf, daß der Be- 
nutzer etwas tut. Die entsprechende 
Routine, die uns diese Arbeit abnimmt 
und uns die vom Benutzer getätigten 
‚Aktionen meldet, istevent_mesag(). Hier 
der Aufruf: 


event = evnt_mesage(buffer); 


Der Eingabeparameter istein Zeiger auf 
einen Speicherbereich von 16 Bytes 
Länge [Wordweise (16Bit) addresiert] 
für die Meldungen. Der Rückgabewert 
ist (zumindest zur Zeit) immer 1. 
Nachfolgend eine Liste der möglichen 
Nachrichten (stehen immer in bufferfOJ; 
Wert in Klammern), auf die unser Pro- 
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typedef struct grect 
{ 

short g_x; 

short g_y; 

short 

short 
} GRECT; 


typedef struct wind data /* Fensterdaten-Struktur */ 


£ 
char 
char 


name[80]; /* Fenstername 
titel[80]; /* Text für Titelzeile 
GRECT max; /* Maximalgröße 


GRECT work; /* Arbeitsbereichgröße 


WORD 
WORD 
WORD 
WORD 
WORD 
WORD 


elements; /* Bestandteile des Fensters 
align; /* Faktor zur hor. Ausrichtung 
snap; /* Fenster snappen (TRUE/FALSE) 
£ull; /* Full-Flag (TRUE/FALSE) 
scroll_x; /* Scroll-Wert für x-Achse 
scroll_y; /* Scroll-Wert für y-Achse 


doc_x; /* x-Position des Dokumentes 
doc_y; /* y-Position des Dokumentes 
doc_length; /* Dokumentslänge 

doc_width; /* Dokumentsbreite 

(*äraw)(); /* Pointer auf Zeichenfunktion 


} WIND_DATA; 





Listing 1: Definition der GRECT- und Fensterdaten-Struktur 


gramm entsprechend zu reagieren hat 
(eine Zusammenfassung finden Sie in 
Tabelle 3): 


1. MN_SELCTED(10): Meldung wird 
erzeugt, wenn ein Menüeintrag ange- 
klickt wurde. In diesem Fall enthält buf- 
fer[3] die Objektnummer des Menütitels 
und buffer[4] die Nummer des ange- 
wählten Menüeintrags. 

2. WM_REDRAW(20): GEM verlangt 
von uns, Fenster bzw. Ausschnitte da- 
von neu zu zeichnen, da diese zerstört 
wurden (z.B. durch Verschieben eines 
anderen Fensters). buffer[3] enthält da- 
bei die Identifikationsnummer (richtig, 
das handle!) des wiederherzustellen- 
den Fensters, buffer[4] bis buffer[7] die 
Koordinaten (x, y, Breite, Höhe) des 
Fensterbereichs, der neu gezeichnet 
werden muß. 

3.WM_TOPPEDI(21): Das Fenster, des- 
sen handle in buffer[3] steht, wird zum 
neuen aktuellen Fenster, dader Anwen- 
der dieses angeklickt hat. Gehört das 
Fenster zu unserem Programm, erledi- 
gen wir dies mittels wind_set(): 
wind_set(buffer[3], WF_TOP, buffer[3], 
0, 0,0); 

4.WM_CLOSED(22): Der Benutzer hat 
dieSchließecke des Fenstersangeklickt, 
d.h. unser Programm soll das Fenster 
vom Bildschirm verschwinden lassen. 
Mit wind_close(buffer[3]) kein Problem! 
5. WM_FULLED(23): Der Benutzer hat 
die Volle-Größe-Ecke angeklickt, und 
unser Programm sollentweder das Fen- 


ster (handle in buffer[3]) auf die volle 
Größe bringen (normalerweise der gan- 
ze Desktop bzw. die in wind_create() 
angegebenen Werte) oder, wenn dies 
bereits der Fall ist, es auf die vorherige 
Größe verkleinern. GEM ermöglicht dies, 
da es die vorherigen, die momentanen 
und die maximalen Koordinaten eines 
Fensters speichert. Wir können mit 
wind_get() darauf zugreifen. Im Mana- 
ger erledigt diese Aufgabe eine eigene 
Funktion handle_full(). Sie ermittelt zu- 
erst die vorherigen, momentanen und 
maximalen Koordinaten, vergleicht die 
momentane Größe mit der maximalen 
und vergrößert bzw. verkleinert dann 
das Fenster wie gewünscht. 

6. WM_ARROWED(24): Pfeile oder 
grauschraffierter Bereich des Scroll- 
Balkens des Fensters aus buffer[3] 
wurden angeklickt. In buffer[4] befindet 
sich eine genaue Angabe über das an- 
gewählte Element (siehe Tabelle 3). 

7. WM_HSLID(25): Der horizontale 
Schieber des Fensters mit der Nummer 
aus buffer[3] wurde bewegt. Neue Posi- 
tion [Wert zwischen 0 (links) und 1000 
(rechts)] steht in buffer/4]. 

8. WM_VSLID(26): Wie 7., nur für verti- 
kalen Schieber (0: oben, 1000: unten). 
9. WM_SIZED(27): Die Fenstergröße 
(Außenmaß) wurde verändert. buffer[3] 
teilt uns die Fensternummer mit (wer 
hätte das gedacht ...?), buffer [4] bis 
buffer [7] die x- und y-Koordinaten so- 
wie die neue Breite und Höhe. 


10.WM_MOVED(28): Das Fenster wur- 
de verschoben. buffer [3] enthält wieder 
die ID des Fenster und buffer[4] bis 
buffer[7] die neuen Koordinaten (Au- 
Benmaß). 

11. WM_NEWTOP(29): Funktion ist 
nicht mehr dokumentiert und sollteauch 
nicht auftreten (hatte wohl ähnliche 
Funktion wie 3.) 


Die folgenden Meldungen sind nur der 
Vollständigkeit halber aufgeführt. Sie 
finden Verwendung bei der Program- 
mierung von Accessories. 

12. AC_OPEN(40): buffer[4] enthält die 
Nummer des Accessories, die durch 
den Aufruf vom menu_register() diesem 
Programm mitgeteilt wurde. Diese Mel- 
dung erhält ein Accessory, wenn sein 
Menüpunkt im Desk-Menü angeklickt 
wurde.(Übrigens: imPC-GEM erscheint 
die Nummer des Accessories in buf- 
fer[3]!) 

13. AC_CLOSE(41): Diese Meldung er- 
hält ein Accessory, wenn a) das laufen- 
de Programm beendet wurde, b) der 
Bildschirm gelöscht wird oder c) Daten 
der Window-Library reinitialisiert wer- 
den. In buffer[3] befindet sich die ID des 
entsprechenden Accessories. Man darf 
jedoch erst ab Atari-GEM 3.0 (ab TT) 
sicher sein, daß die Meldung vor dem 
Endedes Hauptprogramms eintrifft (d.h. 
vor Verlust von Speicherblöcken und 
Dateikennungen)! 


Eine weitere Meldung existiert noch, 
die vom modularen Kontrollfeld (XCON- 
TROL) zur Mitteilung von Tasteneinga- 
ben genutzt wird: 


14. CT_KEY(53) 


Sie können auch eigene Mitteilungen 
definieren und verschicken. So ist eine 
Kommunikation zwischen verschiede- 
nen Programmen und Accessoriesmög- 
lich. In Gemini wird dies als ‘AV-Proto- 
koll’ verwendet. Von DigitalResearch 
werden dafür Mitteilungsnummern grö- 
Ber als 1024 empfohlen. 
Anmerkung: Anstelle von evnt_- 
mesag(), die nur die von GEM-AES ab- 
geschickten Meldungen übermittelt, 
können wir auch evnt_multi() gebrau- 
chen. Diese GEM-Funktion vereinigt 
mehrere andere Funktionen in sich. So 
kann mit ihr auch eine Meldung emp- 
fangen werden, für die sonst evnt_- 
button(), evnt_click(), evnt_keyba(), 
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MN_SELCTED(10): 


WM_REDRAW(20): 


WM_TOPPED(21): 


WM_CLOSED(22): 


WM_FULLED(23): 


WM_ARROWED(24): 


WM_HSLID(25): 


WM_VSLID(26): 


WM_SIZED(27): 


WM_MOVED(28): 


WM_NEWTOP(29): 


AC_OPEN(40): 


AC_CLOSE(41): 


CT_KEY(S3): 


Ein Menüeintrag wurde angewählt 


buffer[3]: Objektnummer des Menütitels 


buffer[4]: Nummer des angewählten Menüeintrags 


Fenster(ausschnitt) restauriert werden 
buffer[3]: handle 

buffer[4]: x-Koordinate 

buffer[5]: y-Koordinate 

buffer[6]: Breite 

buffer[7]: Weite 


Fenster wird aktuelles Fenster 
buffer[3]: handle 





Schließbox wurde angeklickt 
buffer[3]: handle 


Volle-Größe-Ecke wurde angeklickt 
buffer[3]: handle 


Pfeile oder Scroll-Balken wurden angeklickt 

buffer[3]: handle 

buffer[4]: angewähltes Element: 

WA_UPPAGE(0) : Balken oberhalb des Schiebers 
WA_DNPAGE(1) : Balken unterhalb des Schiebers 
WA_UPLINE(2) : Pfeil nach oben 
WA_DNLINEß) : Pfeil nach unten 
WA_LFPAGE(4) : Balken links des Schiebers 
WA_RTPAGEI(5) : Balken rechts des Schiebers 
WA_LFLINE(6) : Pfeil nach links 

WA_RTLINE(7) : Pfeil nach rechts 


horizontaler Schieber wurde bewegt 
buffer[3]: handle 
buffer[4]: neue Position (0: links, 1000: rechts) 


vertikaler Schieber wurde bewegt 
buffer[3]: handle 
buffer[4]: neue Position (0: oben, 1000: unten) 


Fenstergröße (Außenmaß) wurde verändert 
buffer[3]: handle 

buffer[4]: x-Koordinate 

buffer[5]: y-Koordinate 

buffer[6]: Breite 

buffer[7]: Weite 





Fenster wurde verschoben; neue Werte sind Außenmaß 
buffer[3]: handle 

buffer[4]: x-Koordinate 

buffer[5]: y-Koordinate 

buffer[6]: Breite 

buffer[7]: Weite 





Funktion nicht mehr dokumentiert (hatte ähnliche Funk- 
tion wie WM_TOPPED) 


Accessory-Eintrag wurde angeklickt 
buffer[4]: Accessory-Nummer 


Accessory wurde geschlossen (Start oder Ende eines Pro- 
gramms; Fenster muß nicht geschlossen werden) 
buffer[4]: Accessory-Nummer 


Meldung von Tasteneingaben 
(wird von XCONTROL verwendet) 





Tabelle 3: Mitteilungs-Ereignisse des AES; Nummer steht in buffer[0] 


992 FTSonderheit 





evnt_mesag(), evnt_mous() und evnt_- 
timer() zuständig sind. Das heißt z.B., 
daß das Programm auf eine Menüse- 
lektion, eine Window-Aktivität, einen Ta- 
stendruck, eine Mausbewegung und 
einen Timer-Event gleichzeitig warten 
kann. Diese Routine wird, durch Ihre 
Universabilität, in den meisten Fällen 
eingesetzt. Allerdings sollte man bei der 
Verwendung von evnt_multi() beach- 
ten, daß durch die Vielzahl der Parame- 
ter, bedingt durch das Zusammenfas- 
sen mehrerer Ereignis-Routinen, be- 
trächtlich Rechenzeit verbraucht wird 
(von DigitalResearch wird deshalb im 
GEM/3-Toolkit eine Alternative ange- 
boten, bei der nur ein Zeiger auf eine 
Struktur übergeben wird). 

Mit Hilfe der vom AES gelieferten 
Meldungen können wir nun auf die 
Wünsche des Anwendersreagieren und 
das Fenster verschieben, verkleinern 
oder vergrößern und den Inhalt verän- 
dern. 

Stellen Sie sich den Fall vor, daß Sie in 
Ihrem Programm am linken Bildschirm- 
randeine ‘Tool-Kiste’ (anwählbare Sym- 
bole für Operationen; z.B. bei einem 
Layoutporgramm) haben. Diese sollte 
immer zu sehen sein. Außerdem möch- 
ten Sie nicht, daß Teile des Fensters 
außerhalb des Bildschirms zu liegen 
kommen. Dieses können Sie mit den 
bisher vorgestellten Routinen nicht, da 
Sie keinen Einfluß auf die Schiebungen 
des Anwenders haben. Wir brauchen 
also eine Routine zum ‘Snappen’. 


Jetzt wird ‘gesnappt’! 


Um die oben erwähnten Effekte zu ver- 
hindern, können wir das ganze Fenster 
snappen, ‘d.h. es in einen definierten 
Bildschirmbereich zurückschieben. 
„Snappen“ bedeutet also, dafür zu sor- 
gen, daß ein Fenster immer ganz inner- 
halb eines bestimmten Bereiches zu 
sehen ist (meist auf dem ganzen Desk- 
top, natürlich ohne Menüleiste). 

Hinzu kommt, daß man dafür sorgt, 
daß die Koordinaten (der Arbeitsfläche) 
unseres Fensters nur ganzzahlige Viel- 
fache eines definierten Wertes anneh- 
men. Dies ist. z.B. nützlich, wenn man in 
einem Fenster Text ausgeben möchte. 
Denn sind die Fenstergrenzen an Wort- 
grenzen ausgerichtet (Align-Wert 8), läuft 
die Textausgabe etwas schneller ab. 
Für diese beiden Vorhaben brauchen 
wir zwei Funktionen, die wir im folgen- 
den kennenlernen werden. 
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Zum ersten ... 


snap() erwartet als Parameter zwei 
Pointer auf eine GRECT-Struktur, d.h. 
zwei Pointer auf die Koordinaten eines 
Rechtecks. Das erste definiert den Be- 
reich, in dem sich das Fenster befinden 
soll [bei Aufruf normalerweise gleich 
den durch wind_create() mitgeteilten 
Maximalkoordinaten], und das zweite 
spezifiziert die Größe des Fensters. 

In einem Schritt vergleicht die Rou- 
tine die x- und y-Koordinate des Fen- 
sters mit denen des definierten Bereichs. 
Falls das Fenster außerhalb des Be- 
reichs liegt (d.h. falls die x- und/oder 
y-Koordinate kleiner als die des Be- 
reichs ist), schiebt snapp() das Fen- 
ster in den Bereich zurück; Schritt 1 in 
Bild 2 veranschaulicht die Problematik 
hierzu. 

Im zweiten Schritt überprüft snap() die 
rechte untere Ecke des Fensters. Wenn 
deren Koordinaten (Addition von x-Ko- 
ordinate mit der Breite bzw. von y-Ko- 
ordinate mir der Höhe) außerhalb des 
Bereichs liegen, verfährt snap() mit dem 
Fenster wie in Schritt 1 (Bild 2, Schritt 2). 
Nun sollte unser Fenster eigentlich voll- 
ständig innerhalb des Bereichs liegen. 
Schritt 3 in Bild 2 zeigt aber, daß das 
nicht immer der Fall sein muß. Ange- 
nommen, das Fenster besitzt schon 
fast seine maximale Höhe und der Be- 
nutzer betätigt SIZER-BUTTON, um es 
noch weiter zu vergrößern, dann pas- 
siert folgendes: Schritt 1 tritt nicht in 
Kraft, da die Größenänderung keinen 
Einfluß auf die x- bzw. y-Koordinaten 
des Fensters hat. InSchritt2 setztsnap() 
die rechte untere Ecke des Fensters 
gleich der des Bereichs, da die des 
Fensters infolge der Größenänderung 
außerhalb des definierten Rechtecks zu 
liegen kam. Jetzt befindet sich die y- 
Koordinate des Fensters aber außer- 
halb des Bereichs (vgl. Schritt 3 in Bild 
2)!Es wird also nötig, einen dritten Schritt 
einzuführen, der, falls der oben geschil- 
derte Zustand eintritt, die x-Koordinate 
und die Breite bzw. die y-Koordinate 
und die Höhe gleich den Werten des 
eingeschränkten Rechtecks setzt. Da- 
mit liegt unser Fenster immer innerhalb 
des angegebenen Bereichs! 

Es drängt sich auf, snap() beim Auftre- 
ten einer WM_SIZED- bzw. einer 
WM_MOVED-Mitteilung zu verwenden, 
um dem Anwender auf die Finger (bzw. 
auf die Maus) zu schauen. 


Mit Hilfe einer vorher zu definierenden 
Variablen (wird später in eine Struktur 
mit wichtigen Fensterwerten integriert) 
kann festgelegt werden, ob das Snap- 
pen bei einem Fenster erwünscht ist 
oder nicht. Falls ja, führen wir dies aus 
und übergeben snap() als Begrenzung 
die in einem Array festgelegten Maxi- 
malkoordinaten des Fensters und als 
snappende Werte dievonevent_mesag() 
in buffer[4] bis buffer[7] übergebenen 
neuen Koordinaten. 

[Amerkung: Eigentlich erwartet snap() 
Pointer auf GRECT-Strukturen. Im er- 
sten Fall ist dies zwar erfüllt, doch 
im zweiten Fall übergebe ich die Adres- 
se von buffer[4], was zwar nicht ganz 
sauber ist, C aber durchläßt, da ich 
ein Array von n WORD-Variablen 
(WORDarray[n];) auch als Struktur 
von n WORD-Variablen (struct Array 
{WORDx1,x2,x3, ....xn}array;) beschrei- 
ben kann und die einzelnen Variablen 
im Speicher bei beiden Varianten 
hintereinander gespeichert werden. (Der 
Zugriff auf die einzelnen Elemente ist 
natürlich verschieden: array[n] bzw. 
array.xn).] 


„.. und zum zweiten 


Die Funktion align() ermöglicht es uns, 
einen Koordinatenwert auf ein ganz- 
zahliges Vielfaches einer Konstanten zu 
begrenzen. 

Zuerst erhöhen wir die Koordinate um 
die Hälfte des Align-Wertes minus Eins 
[n>>1 bedeutet, daß die Variable n um 
21 nach rechts geshiftet (geschoben) 
wird, was einer Division durch Zwei 
entspricht]. Dann teilen wir diesen Wert 
durch den Align-Wert, nehmen davon 
den ganzzahligen Teil und multiplizie- 
ren ihn wieder mit dem Align-Wert, wo- 
mit wir bereits das ausgerichtete Er- 
gebnis hätten. Beispiel:k=111 und v=16. 
Zuerst erhöhen wir k um 16 geteilt durch 
2 minus 1, also 7 ergibt k=118. Dann 
teilen wir dies durch 16 und nehmen 
den ganzzahligen Teil: 7. Dies mal 16 
ergibt den gesuchten Wert 112, der ein 
ganzzahliges Vielfaches von 16 ist und 
dem ursprünglichen Wert 111 amnäch- 
sten liegt. 

Was geschieht nun, wenn man ein 
Fensterübereinanderesschiebtundes 
danach wieder wegnimmt? Ist dann 
nicht der Inhalt des zweiten Fensters an 
den Stellen, die vom ersten bedeckt 
waren, zerstört? Und was können wir 
dagegen unternehmen? 


im Doppelpack ! 
Einfach einlegen und los geht's 
mit den Disketten zum 


Sonderheft ST-Computer 


Doppelpack PASCAL (2 Disketten) Doppelpack C (2 Disketten) 








na Aus dem Inhalt: 
Alle Disketten enthalten Routinen und Beispielprogramme zu 
folgenden Bereichen: 


Grundlagen: z.B. Window-Routinen, Fractale, Submenüs, ... 

Grafik: z.B. Scrolling, Überblenden, Radieren, Aus- 
schneiden und Kopieren, Zoomen, ... 

Betriebssystem: z.B. eigener Desktop, schnelle Dialogboxen, 
Checkboxen, Short-Cuts in Menüs, ... 


Tricks: z.B. Formelinterpreter, Editor-Modul 





sowie 12 Utilities für den ProgrammiererInen 
z.B.: Dateisuche auf Laufwerken, Hard-Disk-Info, etc. 
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Der (sichtbare) Inhalt des überlappten 
Fensterbereichs ist zerstört, und dage- 
gen unternehmen kann man nichts. (Ist 
wohl auch nicht im Sinne des Erfinders; 
soll doch der Anwender den Bildschirm 
so aufbauen können, wie er möchte!) 
Doch wir können etwas danach in die 
Wege leiten. 


Redraw 


Unter Redraw versteht man ein Wie- 
derherstellen des alten Fensterinhal- 
tes, wenn dieser von einer Dialogbox 
oder einem anderen Fenster überla- 
gert wurde und nun wider offen zutage 
liegt. 

Zum Glück nimmt uns auch hierbei 
das AES ein Teil der Arbeit ab (Sie 
erinnern sich möglicherweise noch 
an die Nachricht WM_REDRAW der 
event_mesag()-Routine?).Wirbrauchen 
bloß zu warten, bis wir mittels evnt_- 
mesagf) [evnt_multi) kann auch ver- 
wendet werden] in buffer[0] den Wert 
von WM_REDRAW erhalten und führen 
dann das Redrawing in einer manager- 
internen Routine durch. 

Und wie? Die Funktion do_redraw() 
erledigt für uns das Drum und Dran 
beim Redrawing. Wirübergeben ihr den 
vonevnt_mesag() gelieferten Pufferund 
lassen sie dann arbeiten: 

Nachdem sie mittels 


v_hide_c(handle) 


den Cursor ausgeschaltet hat, derbeim 
Neuzeichnen stören würde, und da- 
nach mit 


wind_update(BEG_UPDATE) 


dem AES mitgeteilt hat, daß sie nun die 
Kontrolle übernimmt (mit anderen Wor- 
ten, kein Menü mehr heruntergeklappt 
und auch alle anderen Benutzeraktio- 
nen ignoriert werden sollen), beginnt 
die eigentliche Routine. AES übermit- 
telt uns in buffer[4] bis buffer[7] die 
Koordinaten des zerstörten Bildschirm- 
bereichs. Das genügt aber nicht, denn 
wir müssen wissen, welche Bereiche 
eines Fensters neu gezeichnet werden 
müssen (Desktop-Bereiche zeichnet 
GEM selbständig neu). Dazu brauchen 
wir die sogenannte Rechteckliste die- 
ses Fensters. Darin ist der sichtbare 
Arbeitsbereich in verschiedene Recht- 
ecke aufgeteilt (Bild 3 verdeutlicht den 
Sachverhalt). Ist das Fester ganz sicht- 
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Bild 2: Snappen eines Fensters 


bar, besteht die Liste natürlich nur aus 
einem Rechteck (vgl. Fenster 2 in Bild 
3), bei teilweise verdeckten Fenstern 
dagegen aus mehreren (vgl. Fenster 1 in 
Bild 3). 

Die Koordinaten des ersten Rechtecks 
erhalten wir durch 


wind_get(buffer[3], WE_FIRSTXYWH, x, y, b; h), 


die nächsten durch wiederholten Ge- 
brauch von 


wind_get(buffer[3], WF_NEXTXYWH, x, y, b, h). 


Wenn Breite und Höhe der erhaltenen 
Koordinaten gleich Null sind, sind keine 
weiteren Rechtecke vorhanden. Bild 3 
zeigt, was passiert, wenn z.B. eine Dia- 




















logbox einen Teil des Bildschirms ver- 
deckt hat und der darunterliegende 
(schraffierte) Bereich neu gezeichnet 
werden muß. do_redraw() nimmt sich in 
einer Schleife alle vorhanden Rechtek- 
ke vor und untersucht auf Überschnei- 
dungen mit dem zerstörten Bidschirm- 
bereich. Dazu werden in rc_intersect() 
die Koordinaten beider Bereiche vergli- 
chen, bei einer Überlappung die Koor- 
dinaten des Schnittbereichs berechnet 
und TRUE zurückgegeben. Ist dies der 
Fall, d.h. muß ein Bereich neu gezeich- 
net werden, clippt do_redraw() mit 
vs_clip() die Bildschirmausgabe, d.h.es 
werden nur Ausgaben in den angege- 
benen Bereich erlaubt. Darauf löscht 
sie dieses Rechteck. Jetzt wird es Zeit, 
die eigentliche Draw-Routine für das 


Fenster aufzurufen (genaueres siehe 
weiter unten). 

Nach Abschluß dieser Arbeit, also 
nachdem alle beschädigten Bereiche 
eines Fensters neugezeichnet worden 
sind, wird das Clipping wieder ausge- 
schaltet (sonst sind normale Ausgaben 
nicht mehr möglich) und mit 


wind_update(END_UPDATE) 


dem AES die Kontrolle wieder überge- 
ben sowie der Cursor angeschaltet 


v_show_c(handle, TRUE), 


bis eine neue REDRAW-Message vor 
der Tür steht ... (AES schickt für jedes 
betroffene Fenstereineeigene Meldung, 
die bearbeitet werden muß). 

Die Adresse der Draw-Routine wird in 
der oben bereits erwähnten Fenster- 
struktur (näheres folgt in Kürze) einge- 
tragen. Damit kann die do_redraw()- 
Routine für jedes beliebige Fenster die 
Zeichenroutine aufrufen. 

Anmerkung: Der Methode, derer 
do_redraw() sich bedient (Ermitteln der 
Rechteckliste bei einer REDRAW-Mel- 
dung mit anschließendem Neuzeich- 
nen dieser), sollten alle GEM-Applika- 
tionen folgen, auch wenn sie nur ein 
Fenster öffnen, denn es kann ja z.B. 
durch ein Accessory überdeckt wer- 
den. Außerdem kommt hier eines der 
grundlegenden Konzepte von GEM, 
nämlich das Message-Prinzip, voll zur 
Geltung - eines der am meisten mißver- 
standenen Konzepte, das an sich flexi- 
ble Programmgestaltung und ein ge- 
wisses Multitasking erlaubt (siehe Ac- 
cessories). 

Welche Operationen fehlen uns denn 
noch? Sämtliche Manipulationen, die 
etwas mit dem Inhalt des Fenster zutun 
haben (horizontales oder vertikales 
Scrollen des Textes). 

Als erfahrene GEM-Benutzer ist Ihnen 
dies bestimmt mehr als geläufig; um 
z.B. in FirstWord den Text zu scrollen, 
greifen Sie zur Maus und klicken einen 
der Rollpfeile an, verschieben die Roll- 
box an eine andere Position oder klik- 
ken das graue Feld des Rollbalkens an 
(vergleichen Sie auch mit Bild 1, dort 
sehen Sie die Elemente eines Fensters 
beschrieben). Was geschieht, wenn Sie 
einen Rollpfeil anklicken? Der Text be- 
wegt eine Zeile nach oben oder unten 
bzw. einen Buchstabennachrechtsoder 
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links, jenachdem, welchen der vier Roll- 
pfeile Sie angeklickt haben. Wenn Sie 
den grauen Bereich eines Rollbalkens 
anklicken, verschiebt sich der Fenste- 
rinhalt um eine Seite vorwärts oderrück- 
wärts bzw. nach links oder rechts, wo- 
bei die oberste bzw. unterste Zeile der 
vorherigen Seite sichtbar bleibt. Ganz 
anders aber, wenn Sie die Rollbox mit 
der Maus verschieben. Dann springt 
der Text an die entsprechende Stelle. 
Esistso, daß die Länge des Rollbalkens 
die Länge des Dokuments, das sich 
hinter dem Fenster versteckt, darstellt. 
Die weiße Rollbox steht für den mo- 
mentan sichtbaren Abschnitt des Fen- 
sters. D.h. das Fenster stellt eine Art 
von Sichtfenster dar, durch das Sie 
einen Ausschnitt des größeren Doku- 
mentessehenkönnen, jenachdem, über 
welchem Teil Sie es mit dem Rollbalken 
plaziert haben. 


Die Realisierung 


Soweit, so gut. Das Ganze sieht ziem- 
lich einfach aus, jedenfalls für den Be- 
nutzer, für den Programmierer stellen 
sich jedoch einige Schwierigkeiten. Im 
folgenden werde ich Ihnen beschrei- 
ben, wie die Verwaltung von Rollbalken 
inunserer Window-Bibliothek eingebun- 
den ist. 

Zuvor jedoch ein paar Worte zu der 
bereits öftersangesprochenen Fenster- 
struktur. Um einen Window-Manager 
zu schreiben, der unabhängig vom ei- 
gentlichen Programm arbeiten soll, muß 
es Zugriff aufbestimmte Fenstergrößen 
haben. Die in der Fensterstruktur zu- 
sammengefaßten Daten können Sie Li- 
sting 1 entnehmen (hier in C-Notation). 
Zum einen finden Sie dort Zeiger auf 
Texte für den Namen und die Info-Zeile. 
Diese werden benötigt, damit die 
open_window()-Routine des Managers 
ein Fenster auch ohne Fehler öffnen 
kann. Danach finden Sie die Größe der 
Maximalausdehnung und des aktuellen 


gem_ init (); 


w_handle = open window(...); 


Arbeitsbereichs (beide in einer GRECT- 
Struktur, deren Aussehen Sie ebenfalls 
Listing 1 entnehmen können). Neben 
den Elementen, mit denen das Fenster 
ausgestattet ist, sind in dieser Struktur 
auch die Werte für diesnap()- undalign()- 
Funktionen. Ein Flag gibt Auskunft dar- 
über, ob das Fenster in seiner maxima- 
len Ausdehnung dargestellt wird oder 
nicht. Die Scroll-Werte für die x- und y- 
Richtung sowie die Position innerhalb 
des Dokuments und dessen Länge wer- 
den für die folgenden Routinen benö- 
tigt. An letzter Stelle finden Sie den 
Zeiger auf die Draw-Routine, der von 
der Redraw-Routine benötigt wird. Der 
Window-Manager definiert 8 Variablen 
dieser Struktur mit dem Namen win- 
dows, mit deren Hilfe auf die verschie- 
denen Fenster zugegriffen wird. 

Auf die Felder der Window-Struktur, 
auf die unsere sscro/l_wind()-Routine zu- 
greift, möchte ich noch etwas näher 
eingehen: 


work: enthält die aktuellen Koordinaten 
des Arbeitsbereichs [die Fläche inner- 
halb der Titelzeile (evtl. Infozeile) und 
den Rollbalken] 


scroll_x: Scroll-Wert fürx-Richtung, um 
diesen Betrag wird der Fensterinhalt bei 
Betätigung des horizontalen Schiebers 
gescrollt. Bei Textausgabe normaler- 
weise 8 (entspricht den Pixeln auf dem 
Bildschirm). 


scroll_y: Scroll-Wert für y-Richtung, um 
diesen Betrag wird der Fensterinhalt bei 
Betätigungdes vertikalen Schiebersge- 
scrollt. Bei Textausgabe normalerwei- 
se 16. 


doc_x: horizontale Position der linken 
oberen Ecke des Fensters im Doku- 
ment (nicht mit Bildschirmkoordinaten 
zu verwechseln). Zeigt die linke Spalte 
z.B. den dritten Buchstaben eines Tex- 


evnt_mesag(buffer); /* oder evnt_ multi(...); */ 
handle_window (buffer); 


gem_exit(); 





Bild 4: Prinzipieller Verlauf eines GEM-Programms mit Fenster 
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tes mit x-Scroll-Weite 8 an, dann be- 
trägt doc_x 16. 


doc_y: vertikale Position derlinken obe- 
ren Ecke des Fensters im Dokument. 
Zeigt die oberste Zeile des Fensters 
z.B. die dritte Zeile eines Textes mit y- 
Scrollweite 16 an, denn beträgt doc_y 
32 


doc_length: Länge des Dokumentes. 
Angabe in Pixeln. Ein Text von 100 
Zeilen ist so z.B. bei einer Zeilenhöhe 
von 16 Pixeln 1600 Pixel lang. 


doc_width: Breite des Dokumentes. Ein 
Text mit der Breite von 65 Buchstaben 
und 8 Pixeln pro Buchstabe ist daher 
520 Pixel breit. 


Zu wissen, welche Aktion der Benutzer 
getätigt hat, ist kein Problem; dies mel- 
det uns ja das AES mittels der Messa- 
ges WM_ARROWED, WM_HSLID und 
WM_VSLID. Eine dieser drei Meldun- 
gen erhalten wir, wenn wir unser Fen- 
ster mit den entsprechenden Elemen- 
ten beim Öffnen ausgestattet haben 
und der Benutzer eines davon ange- 
klickt hat. WM_ARROWED bedeutet da- 
bei, daß einer der Rollpfeile oder einer 
der grauen Bereiche angeklickt wurde 
und der Benutzer entweder eine Zeile 
oder eine Seite weiter- bzw. zurückblät- 
tern odernach rechts oder links blättern 
möchte. WM_HSLID meldet AES bei 
Verschiebung der horizontalen Rollbox, 
analog WM_VSLID bei Verschieben der 
vertikalen Rollbox. 

Um diese Meldungen zu handhaben, 
existieren entsprechende Funktionen, 
die die notwendigen Schritte durchfüh- 
ren: Mittels scroll_wind() verwalten wir 
eine WM_ARROWED-Message. Der 
Funktion übergeben wir das handle des 
Windows (buffer[3]) und den Inhalt von 
buffer[4], der die vom Benutzer getätig- 
te Aktion genauer spezifiziert (siehe Ta- 
belle 2). Vergleichen Sie hierzu das 
switch-statement in scroll_wind(). Je 
nachdem wird dann die Dokumenten- 
position um den Scroll-Wert vermindert 
oder erhöht. Beispiel: 


case W_UPLINE: 
windows[w_handle].doc_y -= 


windows[w_handle].scroll_y. 


Um aber zu verhindern, daß der neue 
Wert größer als die Dokumentenlänge 
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bzw. kleiner als Null wird, muß eine 
zusätzliche Überprüfung durchgeführt 
werden: 


if(windows[w_handle].doc_y < 0) 
windows[w_handle].doc_y=0 


bzw. 


if(windows[w_handle].doc_y > 
windows[w_handle].doc_length) 
windows[w_handle].doc_y = 
windows[w_handle].doc_length 


Diese Methode funktioniert bei zeilen- 
weisem Rollen; bei seitenweisem Ver- 


schieben kommt aber noch hinzu: es 
wäre sinnvoll, jeweils die letzte Zeile der 
vorherigen Seite mit anzuzeigen. Eine 
Seite entspricht hier immer der aktuel- 
len Größe des Arbeitsbereiches. Wir 
müssen die Dokumentsenposition also 
um die Größe des Arbeitsbereichs plus/ 
minus der x- bzw.. y-Scroll-Weite ver- 
mindern/erhöhen. 


Beispiel: 


case W_DNPAGE: 
windows[w_handle].doc_y += 
windows[w_handle].work.g_h - 
windows[w_handle].scroll_y 





Aufruf: gem_init()} 
Funktion: GEM-Initialisierung 
Parameter: keine 
Rückgabewert: keiner 


Aufruf: gem_exit() 
Funktion: 


Parameter: keine 
Rückgabewert: keiner 


Rückgabewert: Fensternummer 


Funktion: 


Parameter: 
Rückgabewert: keiner 


Funktion: 
Parameter: 
Rückgabewert: keiner 


Funktion: 


Parameter: 
Rückgabewert: keiner 





‘Abmeldung’ beim GEM 


Aufruf: open_window(w_name, w_title, redraw, kind, algn, snp, s_x, 
s_y, doc_l, doc_w, x1, y1, w1, h1, mx, my, mw, mh); 


Funktion: initialisiert Fensterstruktur, meldet Fenster bei GEM an, 
öffnet es, löscht den Inhalt und setzt die Schieberpositionen 
Parameter: w_name, w_title: Zeiger auf Text für Namens- und Titelzeile 
redraw: Zeiger auf Zeichenfunktion 
kind: Elemente des Fensters (siehe Tabelle 1) 
algn: 0: keine Funktion, >0: align-Wert 
snp: 0: keine Snappen, 1: Snappen wird mit 
maximal Koordinaten (mx, my, mw, mh) 
durchgeführt 
SXSY: Scrollw-Werte in x- und y-Richtung 


doc_l, doc_w: Länge und Breite des Dokuments 
x1,y1,w1,h1:  Eröffnungskoordinaten 
mx, my, mw, mh:Maximalkoordinaten; Desktop falls mw =0 


Aufruf: handle_window(buffer) 

bearbeitet Anwenderaktionen am Fenster (Verschieben, 
Änderung der Größe, Inhalt scrollen ...) 

Zeiger auf Message-Puffer von evnt_mesag() 


Aufruf: clear_window(w_handle) 
löscht Fensterinhalt 
w_handle: Fensternummer 


Aufruf: full_redraw(w_handle) 

zeichnet Fenster komplett neu: Fenster löschen und 
Zeichen-Routine aufrufen 

w_handle: Fensternummer 








Die Überprüfung auf Über- oder Unter- 
lauf der maximalen bzw. minimalen Grö- 
ße bleibt gleich. Nachdem die Doku- 
mentenposition nun so verändert wur- 
de, müssen die Slider (= Rollbalken) neu 
positioniert werden, da sie ja die Größe 
und die relative Position des sichtbaren 
Fensterinhaltes zum ganzen Dokument 
wiedergeben sollen. Hierzu dient set_- 
slider_pos(), der wir das Handle des 
entsprechenden Fensters übergeben. 
Um die Position der Sliders setzen zu 
können, muß man wissen, daß dieGEM- 
Entwickler die maximale Länge des 
Rollbalkens auf 1000 festgesetzt ha- 
ben. Wir müssen also die Dokumenten- 
position entsprechend umrechnen. 
Hier die verwendete Formal: 


Schieberposition = 
Dokumentenposition * 1000/ 
(Dokumentengröße-Arbeitsbereichsgröße) 


Ein spezieller Fallmuß aber berücksich- 
tigt werden: ist die Arbeitsbereichsgrö- 
Be größer als die Dokumentengröße, 
würde die Schieberposition ungewoll- 
terweise negativ, wir müssen diesen 
Fall durch eine if-Abfrage abfangen. 
Nach der Berechnung der neuen Posi- 
tion können wir diesen Wert GEM mit- 
tels wind_set() mitteilen. 

Für WM_HSLID und WM_VSLID exi- 
stieren zwei eigene Funktionen: wind_- 
hslide() und wind_vslide(). Beideberech- 
nen im Prinzip dasselbe, nur entweder 
horizontaloder vertikal, nämlich dieneue 
Dokumentenposition. Dies ist der um- 
gekehrte Fall von vorhin, bei der 
set_slider_pos() war die Dokumenten- 
position bekannt, und die des Sliders 
mußte berechnet werden. Jetzt ist die 
des Sliders (buffer[4]) bekannt, und wir 
müssen die neue Dokumentenposition 
ermitteln. Aus der oben genannten For- 
mel läßt sich dies leicht ableiten: 


Dokumentenposition = 
Schieberposition * (Dokumentengröße - 
Arbeitsbereichsgröße)/1000. 


Schließlich darf man nicht vergessen, 
die neue Slider-Position mittels wind_- 
set() zu setzen, da dies GEM nicht selb- 
ständig macht. Zu allerletzt wird das 
ganze Fenster neu gezeichnet, da sich 
jader Inhalt verschoben hat. Dazu rufen 
wir full_redraw() auf, das nichts anderes 
macht, als den Fensterinhalt mittels 
clear_window/() zu löschen und je nach 
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Fenster die entsprechende Redraw- 
Routine aufzurufen. 


Sehr schön, aber ... 


... darf man keinesfalls vergessen, daß, 
wenn das Fenster in der Größe verän- 
dert wird, sich die Schiebergrößen än- 
dern, da die Rollbalkenlänge verändert 
wird. Wir rufen deshalb, nachdem das 
Fenster in der Größe verändert wurde, 
die Routinen wind_calc_work() und 
set_slider_size() auf. Wind_calc_work() 
berechnet aus den Koordinaten des 
gesammten Fensters diejenigen des Ar- 
beitsbereiches und trägt die neuen Da- 
ten in die Struktur ein. Set_slider_size() 
berechnet, wie der Name schon sagt, 
die neue Größe der Slider und teilt die- 
sen Wert GEM mit, das dann die Slider 
neu zeichnet. Des weiteren müssen wir 
auch daran denken, daß bei einer Betä- 
tigung des Volle-Größen-Ecks die Fen- 
stergröße verändert wird. 


Endlich 


Sie haben nun eine praktische Window- 
Bibliothek in den Händen, die es Ihnen 
ermöglicht, Fenster in GEM einfach zu 
handhaben. Die einzelnen Funktionen 
des Window-Managers, welche Aufga- 
ben sie erledigen und welche Werte Sie 
übergeben müssen bzw. zurückgelie- 
fert bekommen, entnehmen Sie bitte 
dem Kasten. In Bild 4 sehen Sie den 
prinzipiellen Aufbau eines GEM-Pro- 
gramms bei Verwendung des Window- 
Managers. Sie können die komplette 
Bibliothek extra übersetzen und zum 
eigentlichen Programm dazulinken; ver- 
gessen Sie aber nicht die Header-Datei 
mit der Definition der Fensterstruktur. 
Natürlich steht es Ihnen frei, die Biblio- 
thek Ihren Wünschen anzupassen und 
zu erweitern - Möglichkeiten gäbe es 
noch genug ... 
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PKS EDIT, die neue Version 2.0 des flexiblesteı 


Text-editors schlägt wieder alle Rekorde: 


® Makroprogrammierung macht PKS-Edit belie- 
big durch den Anwender erweiterbar. Eine mäch 
tige Makrosprache (ähnlich C) erlaubt Zugriff au 
alle Funktionen, eigene Funktionen können neu er. 
stellt werden. 

© umfamgreiche Info- und Hilfefunktionen biete: 
jederzeit einen Überblick über die aktuelle Konfi 
guration. 





@ viele neue Funktionen, wie automatische Text- 
formatierung, einstellbare automatische Einrük- 
kung von Schachtelungen, nochmals erweitert: 
und vereinfachte Suchfunktionen und vieles mehr. 
PKS EDIT läuft mit allen Systemkonfigurationen — 
auch auf dem TT. it 
"sauberer GEM-Editor, sehr schnell, reguläre Ausdrük | 
ke, Makros, Spaltenblöcke, Undo für alle Funktionen." 
".in der Praxis erwies sich PKS-EDIT als absolut zu- 
verlässig, 
". PKS-EDIT hat im Test überzeugt und kann nur || 
empfohlen werden.” 







Tostim ST Magazin, Heft 1010 


Test im ST Computer, Hafı 12190 


PIKS CALCONVERT, die einfache Schnittstelle zwi- 
schen Datenbanken und CALAMUS® | Reports 
aus Datenbanken können jetzt endlich ohne 
größere Nacharbeiten importiert werden. Serien- 
briefe mit verschiedenen Schriften, Etiketten, For- 
mulare werden direkt für CALAMUS® erstellt ! 


N 


N 






PKS Shell 
Welt. 

"„durchdachtes, gut gegliedertes und informatives _ 
Handbuch, leichte Installation, umfangreiche Sammlunj 
von Standarddienstprogrammen" 


der ideale Einstieg in die UNIX® 











Tas im ST Magazin 12190 

® Riesiger Funktionsumfang mit make, cpio, 
sed,... (fast 100 verschiedene Befehle) 

« Ein, Ausgabeumlenkung, Pipes. Ausgefeilt: 
Kommandosprache mit if, case, for,... zur Er- 
stellung von leistungsfähigen Shellprogrammen 

« Parametrisierbare Shellfunktionen (auch reku: 
siv) möglich 








Unv. Preisempfehlungen: ?K$ EDIT DM 148 
PK Shell DM 168.- , EDIT+Shell als Paket nu 
DM 248.-, PK$ CALCONVERT DM 58.- 


Demodiskette bei uns erhältlich für DM 10.- (Scheck, etc.) UNIX® ist 
eingetragenes Warenzeichen von AT & T, CALAMUS® ist eingetra 
genes Warenzeichen von DMC. 


Vertrieb in der Schweiz: EDV Dienstleistungen » Erlenstr. 73 « CH-8805 
Richterswil « 01/784 89 47 


‚hie 
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Submenüs 
unter GEM 


Welcher ATARIST-Besitzer hat 
nicht schon einmal neidisch 
zu anderen Computern, wie 
zum Beispiel dem AMIGA oder 
dem Mac, hinübergeschielt, 
wenn es um die Darstellung 
von Submenüs ging? Es geht 
allerdings auch auf dem Atari. 
Dazu genügen einige wenige 
Routinen, die zum eigenen 
Programm hinzugebunden 


werden müssen. 
D wie man unter GEM “echte” Sub- 
menüs implementiert. Unter “ech- 
ten” Submenüs verstehe ich solche, die 
schon dann herausklappen, wenn der 
Mauszeiger einen Menüeintrag nur be- 
rührt und die automatisch auch wieder 
verschwinden, wenn sich die Maus wei- 
terbewegt - “echte” Submenüs eben... 
Um jetzt zuerst einmal die Ungeduldi- 
gen und Ungläubigen zufriedenzustel- 
len, sollteich hierals erstes vielleicht die 


ie hier vorgestellte Lösung zeigt, 
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Vorgehensweise zur Installation der auf 
der Diskette befindlichen Program- 
me erklären. Sie heißen MENUDEMO 
und SUBMENU. Während SUBMENU 
alle für die Darstellung und Verwaltung 
der Submenüs notwendigen Routinen 
enthält, stellt MENUDEMO lediglich ei- 
ne Beispielapplikation dar, die eine Me- 
nüleiste auf den Bildschirm bringt und 
auf das Anklicken von Submenüs rea- 
giert, indem sie die Indexnummer des 
angeklickten Objekts ausgibt. Im fol- 
genden wird anhand dieses Demopro- 
gramms beispielhaft die Konstruktion 
und Bearbeitung von Submenüs be- 
schrieben. 

Zusätzlich zum abgedruckten MENU- 
DEMO-Programm sind noch zwei Re- 
source-Files notwendig, die nach fol- 
genden Angaben mit einem RCS kon- 
struiert werden sollten. Auf einen Ab- 
druck der Resource-Files in Form von 
Strukturen habe ich hier verzichtet, da 
die Konstruktion der Menüleisten mit 
einem RCSmitSicherheitschnellergeht 
als seitenlanges Abtippen, zumal ge- 
naue Größen oderähnlichesnicht wich- 





tig sind. Anschließend sind beide Pro- 
gramme, also MENUDEMO und SUB- 
MENU, zu compilieren und zusammen- 
zulinken. 

Was muß nun genau getan werden? 
Es müssen zwei Resource-Files er- 
zeugt werden, die jeweils eine Menülei- 
ste enthalten. Die Betonung liegt dabei 
auf zwei Resource-Files. Warum das so 
sein muß, wird weiter unten noch er- 
klärt. Dabei enthält das eine Resource- 
File die ganz normalen Resourcen des 
Programms, wie zum Beispiel Dialog- 
boxen und eben auch die ganz normale 
Menüleiste. Das andere Resource-File 
hingegen enthält lediglich eine einzige 
Menüleiste mit allen Submenüs. Das 
Aussehen der ersten Menüleiste eines 
fiktiven Programms kann man in Abbil- 
dung 3 sehen. 

Dies ist die ganz normale Menüleiste 
mit dem Desk- und zwei weiteren Drop- 
Down-Menüs. Sie ist im RCS mit dem 
Namen MENU zu versehen und diegan- 
ze Datei muß als MENU.RSC abgespei- 
chert werden. Die einzelnen Einträge 
erhalten der Einfachheit halber nach 
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Abbildung 1 


Abbildung 2 


|5-9 Pakete je 13,- DM! 
ab IO Pakete je 12,- DM! 


24 Pakete - 


je 5 Disketten 


randvoll mit Spitzen-PD-Programmen! 
l: Spiele 

4: Einsteiger 
7. Erotik (18) 


10:Digi-Sounds 
13: Top-Acc's 
16: Quiz & Party 
19: Sigum-PD 


2: Anwendungen 3: Spiele, f 
5. ClipArtl 

8: Farbshows 

1; Wissenschaft 
14: DIP 

17: Sportspiele 

20: Ballerspiele 


12: Utilities 
15: Business 
18: Lernen 


6: Midi & Musik 
9: Erotik, f (18) 


2: Clip-Arts2 
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RIEMANN Il ist der Nachfolger des bekannten 
Computeralgebrasystems RIEMANN 


Symbolische Mathematik 

Numerik, 2- und 3-D Graphiken 

Eigene LISP-ähnliche Programmiersprache 
Formula Modelling 

Wartungs- und Updateabonnement, bester 


RIEMANN II 


mbolisches. Algebra- und 
Programmiersystem 


mathematisch exakte Ergebnisse, 


bel. genaue rationale und Fließ- 
kommaarithmetik, 


Lsg. von Gleichungen. LG$ u. DGL, 
trig. und hyperb. Funktionen. 
Difterentiation und Integration, 


Grenzwerte u. Reihenentwicklung, 


Summen- und Produktbildung, 
Vektor- und Matrixoperationen, 
interaktiver Programmierkurs 
weitreichende Debugging-Tools, 
Vektoralgebra und -analysis, 


Tensorrechnung (allg. Relativitäts- 
theorie), 


Pattern Matching, 
Public Domain-Routinen 


22:STE-Demos, f 


Erotik Professional: 

N Disks, bei denen Ihnen die 
\ugen überlaufen. Läuft ab 
os BE 1.4 aufwärts. 


23: Zeichnen 


Q-Tec Maus: 
290 dpi, Maus- 

halter, Anschlüße 
Ai ‚Atari 5 Amiga 


24: Brettspiele 


Videotext 2: 

Jeizt wird Ihr Alari zum 
Videolexidecoder. Immer 
aktuelle Informalionen 
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Computer & Seaware 


. 09343/3854 ' Fax: 


09343/8269 





Interface ist der Resource- 
Editor für Atari ST(E) und 
TT. Komfortabel, flexibel und 
ein Freund von Icons. Eine 
Idee von SHIFT. 


Herausragende Features: Unter- 
stützung aller Formate inkl. 
MS-DOS, Ausgabe als C-Sour- 
ce, Anzeige benutzerdefinierter 
Objekte durch externe (eigene) 
Programme, schneller, komfor- 
tabler Icon-Editor mit Zeichen- 
funktionen, Grafikbibliothek 
und Maskenberechnung, Be- 
dienung per Maus und Tastatur 
mit fliegenden Dialogen, ... 


Interface ist eine 100%ige GEM- 
Applikation, auflösungsunab- 
hängig und durch eigene Routi- 
nen erweiterbar. Zum Liefer- 
umfang gehören C-Bindings, mit 


Der Knüller: Für 3,50 DM gibt's 2 Katalogdisks mit Powerprogrammen!!!!! 





Service bei Problemen und Fragen 
Testberichte in PD-Journal 7/8 91 und TOS 7/91 
RIEMANN II kostet nur 298- DM, gegen 
Nachweis für Schüler und Studenten sogar 
nur 218- DM. Der Versandkostenanteil be- 
trägt 550 DM 

Bestellungen mit Verrechnungsscheck oder 
gegen Rechnung an 















Begemann & Niemeyer 
Softwareentwicklung GbR 
Göllnitzer Str. 12 
7500 Karlsruhe 4] 
Tel. 0721 / 404703 (Fax: 496427 


einfach unsere ausführliche, 
Informationsschrift an 















Fordern Sie 
kostenlose 









Oberflächlich 


betrachtet: 
schöne neue 
Programme. 


denen die Programmierung von 
GEM-Anwendungen erheblich 
erleichtert wird. 


Das schönste: „das beste Re- 
source Construction Set“ (siehe 
ST-COMPUTER 1/91 und TOS 
11/91) kostet nur 98 DM (unverb. 
Preisempfehlung). 


SHIFT 
KOMPAGNIESTRASSE 13 
W-2390 FLENSBURG 

= (0461) 2 28 28 FAX 17050 


Interface. 


Der Beste im 
lest. 





fachen gibt's... 
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Desk Datei Font 
four message here Bildtyp System 
ER RT IRERT en eERge Ne Bild laden Computer 


Desk Accessory i 
Desk Accessory 2 
Desk Accessory 3 





Bild speichern 











Desk Accessory 4 
Desk Accessory 5 
Desk Accessory 6 











Abb. 3: Die erste Menüileiste mit den aufgeklappten Menüs 























Desk Bildtyp Systen Computer Stil 
Your message here Neo 6 Pixel |V 8 Pixel fett 
er “ Degas 8 Pixel 16 Pixel |Y kursiv 
Desk Accessory 1 |\Y Pic vi6 Pixel breit 

Desk Accessory 2 Ing 











Desk Accessory 3 


Desk Accessory 4 
Desk Accessory 5 
Desk _Accessory 6 





Abb. 4: Die zweite Menüleiste mit allen Submenüs 


Möglichkeit die gleichen Namen wie 
der in ihnen stehende Text, also: 


Datei 
Bildtyp 


Font 


System 
Computer 
Stil 


Laden 
Speicher 
Ende 





Die restlichen Einträge, wie zum Bei- 
spiel im Deskmenü, brauchen nicht be- 
nannt zu werden, da sie von MENUDE- 
MO nicht benutzt werden. 

Abbildung 4 zeigt die zweite Menülei- 
ste; sie enthält alle Submenüs. Die Ver- 
teilung der Haken und “disabled”-ten 
Einträge ist dabei willkürlich gewählt. 
Im Grunde genommen ist wie bei der 
obigen Menüleiste der gesamte Textin- 
halt eigentlich völlig belanglos, aber ir- 
gendetwas Sinnvolles sollten die Ein- 
träge ja nun doch enthalten. Wer will, 
kann die Menüs ganz nach Lust und 
Laune gestalten, die Namen der Einträ- 
ge müssen jedoch die gleichen bleiben! 

Diese Menüleiste ist als SUBMENU zu 
definieren und als SUBMENU.RSC ab- 
zuspeichern. Die Überschriften der Me- 
nüs, also die Menütitel, sind eigentlich 
völlig egal; sie werden nicht benötigt. 
Um jedoch deutlich zu machen, wel- 
cher Menüeintrag in der in Abbildung 3 
gezeigten Menüleiste ein Submenü be- 
kommen soll, sollte man hier der Über- 
sicht halber die Titel identisch wählen. 
Falls man aber mal vor dem Problem 
stehen sollte, daß man wegen zu langer 
Menütitel nicht alle Submenüs in eine 
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Zeile bekommen sollte, kann man die 
Namen natürlich auch beliebig kurz 
wählen; ein Zeichenreicht völlig aus, da 
die Titel nirgendwo im späteren Pro- 
gramm erscheinen. Hier jetzt die Na- 
men der obigen Einträge; man beachte 
dabei, daß die Titel keinen Namen be- 
kommen: 





Neo System6 Comp8 Fett 

Degas System8 Comp16 Kursiv 
Pic System16 Breit 
Img 





So, nachdem jetzt die erforderlichen 
Vorarbeiten, d.h. das Erstellen der Re- 
source-Files, geleistet wurden, müssen 
nur noch die beiden Programme abge- 
tippt und anschließend compiliert und 
zusammengelinkt werden. Eigentlich 


müßte jeder, der bis jetzt noch gezwei- 
felt hat, die Hände über dem Kopf zu- 
sammenschlagen. - Entweder, weil die 
Submenüs so toll sind, oder weil man 
tatsächlich alles richtig gemacht hat... 

So weit, so gut (oder auch schlecht, 
kommt darauf an...), nun noch die oben 
versprochene Erklärung, warum man 
keine zwei Menüleisten in einem Re- 
source-Fileanlegen kann; d.h.mankann 
schon, aber dummerweise werden die- 
sevomRCSanschließendineiner Struk- 
tur abgespeichert. Auch das wäre im 
Grunde genommen eigentlich nicht 
weiter tragisch, wenn nur auch die Indi- 
zes zur Adressierung der Objekte um- 
gerechnet werden würden... Da dies 
aber nun einmal nicht der Fall ist, bleibt 
eben nichts anderes übrig, als zwei Re- 
source-Files zu verwenden. 

Auch hierbei gibt es jedoch wieder 
einen Haken: “Offiziell” kann GEM le- 
diglich ein Resource-File verwalten; wie 
man dieses Problem löst, kann dem 
Listing MENUDEMO entnommen wer- 
den; eine genaue Beschreibung des 
Vorgehens ist schon in zahlreichen an- 
deren Artikeln, u.a. auch in der ST- 
Computer, beschrieben worden. 

Deshalb hier nur eine Kurzbeschrei- 
bung der Vorgehensweise in MENUDE- 
MO: Nach dem Laden des ersten Re- 
source-Files werden diesem einfach 
mittels rsrc_gaddr() die benötigten 
Adressen entnommen undanschließend 
die in global[5] stehende Adresse des 
Resource-Files zwischengespeichert. 
Anschließend kann das nächste Re- 
source-Fileeingeladen werden. ZurFrei- 
gabe des ersten Files wird am Ende des 
Programms einfach wieder die Adresse 
zurückgeschrieben. 
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Menüleiste aus Abbildung 3 





jeweils 5 Disketten 
PL3 29,90 


Einsteiger ff Astronomie 
‚PL19 29,90 

| Die Standardausrüstung 
für den Computerneu- 
ling oder Anfänger Von 
der aktuellsten Textver- 
arbeitung, dem besten 
Virenkille. dem neue- 
sten Kopierprogramm, 
den wichtigsten Utilities 
bis hin zum entspannen- 
den Spiel ist in diesem 
Paket auf 6 Disketten 
alles enthalten. 


Drucker 
PL26 29,90 


Alles was Sie für Ihren 
Drucker brauchen ist in 
diesem Paket auf 10 
Disketten enthalten. 
Seien es die unter- 
schiediichsten Treiber, 
‚Ausdruckprogramme, 
Etikettendruckpro- 
gramme, Posterdruck, 
Scheckdruck, Formu- 


11 Diskettei 
PL20 39,90 


PL16 29.90 
Die komplette 
Satzeyetome ToX 3.1 für den BL28 Een ® 
ST. Neben TeX selbst enthäit Zuen 
das Paket alle Druckertrei- 
ber (auch für Laser und Post 
Script) Fonts, Metafont sowie 4 
TeX-Draw: Vektorzeichenpro- 
gramm und ZPCAD: CAD-Pro- 
gramm mit Schnittstelle zu 
Tex. 


des Sequenzer laden, AMP auf 10 stellen, 


Subase’, Cubeal‘, Twenty Fuurs 
oder Twelve* laden und mit unseren 
PD.-Midi-Songs abfahren. Bei den neu- 
en Paketen 28 und 29 liegen die Midi- 
Files im C-LAB, Twenty-Four-Format 
und MIDI-Standart vor. Paket 28 
enthält ausschließlich deutsche Songs. 
während Paket 29 ausschließlich engli- 
sche Songs enthält. 


eisren, eoliton Sie eich 
dieses Pakef zulegen. 
So ist-auf 2=Disks 
zB. enthalten: 

Kepler, Ası 

Sternbils, Planel, 

Sternzeit. - Epfhameti 

Astro, Cluster. Sunshin. Wella, 
Gnomplot, N-Körper, Skymenu. 
‚Sky 2000, Starfinder. Sonneuhr, 
Kalander, Sternkatalog. Stern 
uhr, Sternkugei .... 


6 Disketten 
PL17 29.90 


Dieses Paket ist für Anwender von Signum oder 
‚Script zusammengestellt worden. Es entl jede 
Menge Grafiken, Zeichensätze und spezielle Tools 
wie z.B. Funktionstastenbelegung, große Fonts, ge- 
‚drehte Fonts, Lineal ... 


je 7 Disks 
PL6a 29,90 
PL6b 29,90 


Diese Pakete enhalten jeweils ca. 100 Signum- bzw. 
Script-PD-Zeichensätze. Jeder Zeichnsatz liegt für 
9-, 24-Nadel und Laserdrucker bei 


PL3O 39,90 


Jede Menge Grafiken im CVG- und GEM-Format (Vek- 
torformat), Diese Vektorgrafiken eignen sich besonders für 
DTP Die Grafiken wurden alle selbst vektorisiert, so daß 
Überschneidungen mit anderen Serien ausgeschlossen 
sein dürften. Einige Beispiele sehen Sie in diesem Kasten. 


Pac-Grafiken 
PL8 29,90 
PL14a 29.90 
PL18a 29,90 


IMG Grafiken 
PL14b 39,90 
PL18b 39,90 
PL18c 39,90 


je 12 Disks 


PL21c (sw 29,90 
PL21d (Farbe) 29,90 


12 Disketten (8/ 
w - Fartie) erhalten Sie die 
besten MD-Spiele. Damit 
sind viel? unterhaltsame 
‚Stunden ge\rantiert. 


12 Disks 
PL24 39,90 


Paket 8, 14a und 18a enthalten jeweils 5 
Disketten gefüllt mit Grafiken im PAC- 
Format zum direkten Einbinden in 
'Signum- oder Scriptdokumente. Die übri- 
‚gen Pakete (14b, 18b, 18c) enthalten Gra- 
fiken im IMG-Format auf jeweils 10 Disks. 
Die Grafiken wurden alle selber gescannt, 
so daß Sie in bisherigen FD--Serien nicht 
enthalten sein dürften. 


Weit über 500 Pictogram- 
me zu den unterschiedlich- 
sten Themengebieten. Je- 
de Grafik ist im CVG, GEM FE 
und IMG-Format abgespei- 
chert. 


> Portfolio 


S 
7 Disketten gefült mit Progranmen für den 
folo. An dieser Stelle nur ein paar 
Beispiele: Disk Tools mit Backup-PRG, Clock, 
Fiter, Adressverwaltung UP91 VDE1S2, 
MMCALC .. Disk Tools 2 mit DBFREAD, 
UNITIO. VOK-MAN, PORTTOOLS ... / Disk 
DFÜ mit ACOM, FT. XTERMI, XTERM2 
PORTFOLI ... / Disk Grafik mit PGEDIT, 
PGSHOW, PGCOMR SNATCH ... / Disk Spiele 
mit Portris, Tetris, Touch, Spacemen / Disk 
Basic mit PBASIC v4.1. TBASIG VO / Disk 
Programm mit FORTH, SMALL-C. 


7 PL30 59,- 


Weitere Hard- und Software auf Anfrage. * 


3,5” -Laufwerk 


Komplett anschlußfertig * voll abgeschirmt * 
atarifarben * 6 Monate Garantie * mit 
Track-Display 


3,5” nur L122 219,- 


Rahmen/Zierrat 


Logi Mouse L113 
Script2 


79, 
L114 278 
L115 378 
L116 69, 
L117 94, 
L118 498,- 
L119 129,- 
4TOM Extension Card ’ 
TOS 2.06 L120 198, 
Overscan L121 120, 


Jeder. der mit DTP oder Textprogrammen arbeitet, die IMG- 
$: oder Vectorformate verarbeiten können, werden sich über 
2 dieses Paket freuen. Denn jetzt können Sie Ihre Dokumente 
a noch besser gestalten (z.B. Geburtstagskarten. Menuekar- 


ten, Plakate, uvm.) Alle Grafiken liegen im 
9 IMG-. CVG- und GEM-Format vor (insgesamt 


VOR 442 39,90 


Hand-Scanner 

Handscanner 32 Graustufen Bildbearbei- 

tungssoftware Repro Studio ST junior 2.0. 
komplett nur L108 498,- 


wie oben jedoch zusätzlich noch das 
Vektorisierungsprogramm Avant-Trace 


komplett nur L109 598,- 


Lynx - das Spielgenie 


Hard Driving (neu) 
Turbo Mub (neu) 
Scrapyard Dog (neu) 
Awesome Golf (neu) 


L100 
L101 

L102 
L103 


79,- 
89,- 
89,- 
78,- 


Ladenlokal in Düsseldorf, Irenenstr. 76c 


Vectorfonts 


Wir bieten Ihnen Vectorfonts aus eigener 
Herstellung für Calamus*. Über 200 Vek- 
torfonts zum unglaublich günstigen Preis von 


L110 249,- 
Für alle die skeptisch sind und sich von der 
Qualität der Schriften erstmal überzeugen 
wollen, hier 15 Fonts für nur 


. Schnupperpaket 
Serif Lil 29, 
Nochmals 50 Vectorschriften und 30 

Vectorgrafiken für nur 


Hobo "ia ao- 
12a 77 Ranmen 
Superhigh ABOSE 


*Calamus ist eingetragenes Warenzeichen der Firma DMC. 


© \ 23 19 


Netzteil 220 Li4 24,00 
Adapter 

Zigareitenanz. 1125 34.90 
Tasche Klein L1AB 24,90 
Tasche groß LIT 34.009 





Checkered Flag (neu) L104 
Tourn. Cyberballlneu) L105 
Viking Child (neu) L106 
Ishido (neu) L107 





Imfolgenden nun das weitere Vorgehen 
nach dem Laden der Resource-Files. 
Zur Installierung der Submenüs muß 
ein Aufruf der Form init_submenus() ge- 
macht werden. Dabei müssen folgende 
Parameter übergeben werden: (Siehe 
Tab.1). 

Anschließend kann die Menüleiste 
dann ganz normal mit menu_bar() in- 
stalliert werden. 

Daran schließt sich eine evnt_multi()- 
Schleife an, die bis zum Anklicken des 
“Ende”-Eintrags durchlaufen wird. In 
ihr wird auf das Anklicken der Menü- 
einträge reagiert (MU_MESAG) und in 
regelmäßigen Abständen (MU_TIMER) 
die externe Variable subnum abgefragt, 
in der der Index des angeklickten Sub- 
menüeintrags zurückgemeldet wird. 
Dieses Vorgehen ist notwendig, da es 
sonst keine andere Möglichkeit (zumin- 
dest nicht ohne Betriebssystemeingrif- 
fe) gibt, den Index zurückzugeben. Die- 
ser Index kann dann zusammen mit der 
Adresse submenu ganz normalzum Zu- 
griff auf das betreffende Resource-File 
benutzt werden, wiemenu_icheck() ver- 
deutlicht. 

Außerdem ist noch ein weiterer Punkt 

zu beachten: Wenn man einen Menü- 
eintrag anklickt, wird das betreffende 
Menü vom Betriebssystem sofort wie- 
der eingeklappt, ohne daß man irgend- 
eine Möglichkeit hätte, dies festzustel- 
len. Deshalb muß bei Anklicken eines 
Menüeintrags, bei dem ein Submenü 
herausklappt, das Submenü anschlie- 
Bend wieder vom Bildschirm entfernt 
werden. 
Dazu dient der Aufruf redraw_bg(). Ei- 
gentlich könnte man annehmen, daß so 
ein Eintrag sowieso nicht angeklickt 
wird, weil viel mehr als das Herausklap- 
pen eines Submenüs (wow!!!) eigentlich 
gar nicht mehr passieren kann, aber 
man glaubt es kaum, was für Leute 
manchmal so vor einem Computer sit- 
zen... 

Einen klitzekleinen Haken hat die Sa- 
che mit dem Einklappen der Menüs 
allerdings noch... Wer an dieser Stelle 
schon mal ein bißchen mit den Subme- 
nüs herumgespielt hat, wird wahrschein- 
lich festgestellt haben, daß bei Anklik- 
ken eines Submenüeintrags mitunter 
zwar das Submenü vom Bildschirm ver- 
schwindet, nicht so jedoch das Menü, 
so daß man wie gewohnt noch einmal 
irgendwohin klicken muß, um auch die- 
ses verschwinden zu lassen. Dies ist 
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typedef struct object 
{ 

int 

int 

int 

unsigned int 


ob_next; 
ob_head; 
ob_tail; 
ob_type; 
ob_flags; 
ob_state; 
*ob_spec; 
ob_x; 
ob_y; 
ob_width; 
ob_height; 


unsigned int 
unsigned int 
char 

int 

int 

int 

int 





Abb. 6: Definition der OBJECT-Struktur 


fast immer dann der Fall, wenn minde- 
stens der dritte Eintrag eines Subme- 
nüs angeklickt wird; bei den ersten bei- 
den Einträgen klappt eigentlich immer 
alles einwandfrei. Woran das liegt, konn- 
te ich bisher (leider) noch nicht ermit- 
teln; dafür habe ich aber festgestellt, 
daß im Normalfall dieser Effekt nicht 
mehr auftritt, wenn einmal eine Dialog- 
box auf dem Bildschirm gestanden hat, 
sei es nun die Dialogbox eines Acces- 
sories oder eine eigene gewesen. Die 
Sache ist zwar seltsam, aber ich glau- 
be, damit kann man leben... - Falls einer 
der Leser zufällig herausfinden sollte, 
aus welchem Grund sich das Betriebs- 
system so verhält und/oder mir eine 
Gegenmaßnahme nennen kann, wäre 
ich für eine entsprechende Mitteilung 
dankbar. 

So, und das warauch schon alles, was 
der 08/15-Programmierer wissen muß, 
um die Routinen in SUBMENU nutzen 
zu können. Wie man sieht, sind insge- 
samt nur zwei Funktionsaufrufe not- 
wendig, um die Submenüs zu handha- 
ben, davon ein Aufruf sogar nur einmal 
am Anfang des Programms zur Initiali- 
sierung. - Einfacher geht's bald nicht 
mehr! Man sollte sich jedoch tunlichst 
die globalen Variablen ansehen, die in 
SUBMENU benutzt werden, da diese 
auf keinen Fall erneut deklariert oder 
verändert werden dürfen! Wen die Funk- 
tionsweise der SUBMENU-Routinen 


. handle: 
. menu: 
. submenu: 


Index-Nr. 
Index-Nr. 
Index-Nr. 
Objekt-Typ, z.B. BOX, TITLE 
Objekt-Flags, 
Objekt-Status, 
siehe unten 
x-Koordinate obere linke Ecke 
y-Koordinate obere linke Ecke 
Breite des Objekts 

Höhe des Objekts 


des nächsten Objektes 
des ersten „Kindes“ 
des letzten „Kindes“ 


z.B. SELECTABLE 
z.B. CHECKED 


nun nicht weiter interessiert, kann an 
dieser Stelle aufhören zu lesen und das 
Heft in die Ecke schmeißen, um sich an 
den tollen Submenüs zu erfreuen, die 
jetzt eigentlich schon auf dem Bild- 
schirm zu sehen sein sollten... Für alle 
anderen erkläre ich ab hier die Arbeits- 
weise der Submenüroutinen. 

Um die Funktionsweise verstehen zu 
können, ist erst einmal der interne Auf- 
bau einer Menüleiste, so wie ihn das 
Betriebssystem sieht, wichtig. Als Bei- 
spiel benutze ich hier wieder die Menü- 
leiste aus Abbildung 3. Abbildung 5 
mag zwar auf den ersten Blick etwas 
chaotisch und unübersichtlich ausse- 
hen, aber wer genauer hinsieht, wird 
feststellen, daß eigentlich alles ganz, 
geordnet zugeht. f 

Dem geübten Programmierer sollten 
die abgebildeten Strukturen sowieso 
nicht so ganz fremd sein; jedes dieser 
Rechtecke steht dort stellvertretend für 
eine Struktur des Typs OBJECT, deren 
genaue Definition (in “C”) man in Abbil- 
dung 6 finden kann. 

Die einzige verwunderliche Tatsache 
mag für Leute, die schon mit OBJECTs 
zutun hatten, höchstens sein, daß nicht 
nur Dialogboxen und ähnliche Objekte 
aus OBJECT-Strukturen aufgebaut 
werden, sondern eben auch Menüs. 
Und da diese im Normalfall immer nur 
aus Textbestehen, wirdman dann eben 
leicht dazu verleitet, zu glauben, daß 


VDI-Gerätenummer 
Adresse der normalen Menüleiste 
Adresse der zweiten Menüleiste mit den Submenüs 


. MAX_SUBMENU: Anzahl der Submenüs 


. m_index: 


Adresse eines Feldes, das in fortlaufender Reihen- 


folge die Indizes der Menüeinträge enthält, bei denen 
ein Submenü herausklappen soll. 





Tab. 1 








etwas anderes als Textdarstellung in 
Menüs auch gar nichtmöglich ist. Wenn 
man sich die OBJECT-Struktur einmal 
genauer ansieht, wird man jedoch 
schnell feststellen, daß sie eine Menge 
Möglichkeiten zur Manipulation bietet, 
zum Beispiel braucht man bloß den 
Objekt-Typ auf BOX zu setzen, ob_spec 
anzupassen, und schon hat man statt 
eines Textes eben eine BOX im Menü! 
Eine andere Möglichkeit istzum Bleistift 
auch das Einbinden von Grafiken - wer 
genug Phantasie hat, dem eröffnen sich 
hier ungeahnte Perspektiven... 

Jetzt aber zur Erklärung des oben ab- 

gebildeten Menübaumes. Wie bereits 
erwähnt, steht jedes der abgebildeten 
Rechtecke für eine OBJECT-Struktur. 
Abgebildet sind dabei die Einträge 
ob_type, ob_head, ob_next und ob_tail 
(in dieser Reihenfolge). Außerdem habe 
ich noch zur Veranschaulichung die In- 
dexnummer jedes Objekts hinzugefügt, 
da die Strukturen in dieser Reihenfolge 
im Speicher abgelegt werden. 
Das Wurzelobjekt mit der Indexnum- 
mer 0 und der Bezeichnung IBOX (=In- 
visible Box) ist dabei ein Rahmen, der 
den gesamten Rest des Baumes um- 
faßt und nicht sichtbar ist (wieder Name 
schon suggeriert). Normalerweise um- 
faßt der Rahmen den gesamten Bild- 
schirm. Vom Wurzelobjekt ausgehend 
spaltet sich der Menübaum dann in 
zwei Teilbäume: 


- links (ob_head) in den Baum für die 
Darstellung der eigentlichen Menüzei- 
le; dieser enthält lediglich die Menü- 
titel, 

-rechts (ob_tail) in den Baum für die 
Darstellung der Menüs. 


Der Eintrag ob_next ist hier nicht be- 
nutzt und deshalb wie auch alle ande- 
ren nicht benutzten Einträge mit einem 
Punkt versehen. Gehen wir nun syste- 
matisch vor und fangen beim linken 
Teilbaum an: Die Box mit der Index- 
nummer 1 ist genau der weiße Streifen, 
der die eigentliche Menüzeile darstellt 
undsicham oberen Bildschirmrand über 
die ganze Breite zieht. Wen das schon 
immer gestört hat, kann hier zum Bei- 
spiel die Breite ändern und schon er- 
streckt sich die Menüleiste beispiels- 
weise nur noch bis zur Mitte des Bild- 
schirms - sieht faszinierend aus (aus- 
probieren)! Aber nicht vergessen, den 
rechten Teil der alten Menüzeile mit der 
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Hintergrundfarbe zu übermalen, sonst 
sieht man nix davon... 

Aber weiter im Menübaum: In die Me- 
nüzeile müssen natürlich noch die Me- 
nütitel gezeichnet werden. Deshalbfolgt 
auf die BOX (Indexnummer 1) noch eine 
IBOX (2), also wieder ein unsichtbarer 
Rahmen, der alle zu zeichnenden Me- 
nütitel - bezeichnet mit TITLE (3-5) - 
umfaßt. Wie man hier sehr schön sieht, 
deutet ob_next jeweils auf das nächste 
gleichartige Objekt in der Reihe. Ist kein 
gleichartiges Objekt mehr vorhanden, 
zeigt ob_next zurück auf das jeweils 
zugehörige Elternobjekt. Im Grunde ge- 
nommen kann man zwar nicht von Zei- 
gern sprechen, da in den entsprechen- 
den Einträgen immer nur die Indexnum- 
mern der Objekte stehen und nicht Zei- 
ger auf sie, aber vom Prinzip her dürfte 
klar sein, was gemeint ist. 





den STRINGs, setzt nun das Verfahren 
für die Darstellung derSubmenüsein.In 
jeder OBJECT-Struktur gibt es den bis- 
her nurkurz erwähnten Zeiger ob_spec, 
derjenach Objekt-Typ auf unterschied- 
liche Strukturen deutet oder auch an- 
dere Informationen enthält; beiSTRINGs 
zeigt er auf den auszugebenden Text. 
Der Vollständigkeit halber habe ich alle 
Möglichkeiten in Abbildung 8 aufgeli- 
stet, benötigt wird hier jedoch nur die 
Möglichkeit, ob_spec auf eine eigene 
Zeichenroutine zeigen zu lassen 
(G_PROGDER). Tabelle 1 ist [1] ent- 
nommen und an ein paar Stellen mit 
Hilfe von [2] noch ein bißchen erweitert 
bzw. korrigiert. 

Um nun ein benutzerdefiniertes Ob- 
jekt zu installieren, muß der Objekt-Typ 
in G_PROGDEF geändert werden und 
ob_spec muß auf einen APPLBLK (Ap- 


OX (2) 
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1BOX (0) 


Während der linke Teil des Menü- 
baums also für die Darstellung der 
Menütitel verantworlich ist, dreht sich 
im rechten Teil alles um die Darstellung 
der Menüinhalte. Wie gehabt, beginnt 
auch hier alles mit einer IBOX (Index- 
nummer 6), die alle (ausgeklappten) 
Menüs umfaßt. Von ihr geht - korre- 
spondierendzu denTITLE-Objekten auf 
der linken Seite - eine Liste aus, die al- 
le BOX-Objekte für die Darstellung der 
Menüs enthält. Jede dieser Boxen bil- 
det dabei selber wieder ein Wurzel- 
objekt für eine Liste von Objekten, in 
diesem Fall (wie auch normalerweise) 
für die Menü-Texte (STRINGs). Wegen 
Platzmangel sind die meisten STRINGs 
in Abbildung 5 lediglich durch Pünkt- 
chen angedeutet. 

Der gesamte Sachverhalt istnoch ein- 
mal so, wie er “in der Realität” auf dem 
Bildschirm aussieht, in Abbildung 7 zu 
sehen. Genau an dieser Stelle, nämlich 


1BOX (6) 








Abb. 7: 

Der Menübaum 
als “realistische” 
Darstellung 


plication Block) zeigen, der wie in Abbil- 
dung 9 definiert ist. 

Und genau so - naja, um ehrlich zu 
sein: ungefähr so - geht die Routine 
init_submenus() vor. Zuerst wird für je- 
des Submenü eine Struktur angelegt, 
die ich ext_appl_bik (für Extended 
APPLBLK) genannt habe, da man mit 
der normalen APPLBLK-Struktur für 
meine Zwecke nicht genug Parame- 
ter übergeben konnte. Dadurch, daß 
man die Struktur frei im Speicher an- 
legen kann und sich an fast keine 
Konventionen halten muß, ist es ohne 
weiteres möglich, die normale APPL- 
BLK-Struktur beliebig zu vergrößern 
und zu erweitern; lediglich die ersten 
beiden Einträge müssen wie beiAPPL- 
BLK sein. 

Der genaue Aufbau von ext_appi_bik 
kann demListing SUBMENU.C entnom- 
men werden; es hat sich im Grunde 
nicht viel getan, außer daß noch zwei 
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Einträge hinzugekommen sind. Beidem 
einen Eintrag (char *text) handelt essich 
um den geretteten Zeiger auf den Me- 
nütext; dieser wird ja auch weiterhin 
noch benötigt. Der andere Eintrag 
(LONG regA4) ist Megamax-C-spezi- 
fisch und muß bei Benutzung anderer 
Compiler vermutlich angepaßt werden 
bzw. kann ganz entfallen. In der An- 
fangsphase der Entwicklung ist mir das 
Programm nämlich ständig abgestürzt, 
bis ich herausgefunden hatte, daß bei 
Aufruf der neuen Zeichenroutine aus 
dem Betriebssystem heraus fast alle 
Register des Prozessors geänderte Wer- 
te aufweisen, so auch das Adreßregi- 
sterA4.Dadieses vom Megamax-Com- 
piler jedoch zur Adressierung der glo- 
balen Variablen benutzt wird, kann man 


Objekttyp 


G_BOX 








GRUNDLAGEN 


typedef struct appl_blk 
{ 


int (*ub_code) (); 
long ub_parm; 


/* Zeiger auf ein 
/* Parameter, der 

übergeben wird 
} APPLBLK; 


Abb. 9: Definition der APPLBLK-Struktur 


davon ausgehen, daß in so einem Fall 
das Programm zumeist mit einer Bom- 
ben-Stimmung ins Computer-Nirwana 
eingeht. Deshalb wird bei Initialisierung 
der Strukturen das A4-Register hierher 
gerettet und später bei Aufruf der Zei- 
chenroutine wiederhergestellt. 

Wer also einen Compiler besitzt, der 
die globalen Variablen über ein anderes 
Registeradressiert, muß dannebenstatt 


Bedeutung von ob_spec 


Byte 0 und Byte 1: Farbe des Objekts 


Für die Objektfarbe sind die Bits folgendermaßen 


belegt: 
aaaa: 
bbbb: 
[2 

dad: 


aaaabbbb cdddeeee 

Rahmenfarbe (0-15) 

Textfarbe (0-15) 

Text transparent (0) oder deckend (1) 
Füllmuster (0-7) mit ansteigender Dunkelheit 


(0 kein Füllmuster, 7 solides Muster) 


eeee: 


Byte 2: 
0= 
1-128 = 


kein Rand 


Farbe des Objektinneren 
enthält die Dicke des Objektrandes: 


Dicke des Randes in Pixeln, nach innen zählend von 


den Ecken des Objekts 


-1-(-127) = 


Dicke des Randes in Pixeln, nach außen zählend 


von den Ecken des Objekts 


Byte3=0 


G_TEXT 


Zeiger auf die zugehörige TEDINFO-Struktur, in der die Merk- 


male des Textes festgelegt werden 


G_BOXTEXT 
G_IMAGE 


wie bei G_TEXT 


beschrieben wird 
G_PROGDEF 


Zeiger auf Struktur vom Typ BITBLK, in der das Bit-Image 


Zeiger auf eine Struktur vom Typ APPLBLK, die das benutzer- 


definierte Objekt beschreibt (APPLBLK enthält die Adresse der 
Routine, die das Objekt zeichnet) 


G_IBOX 
G_BUTTON 
G_BOXCHAR 
G_STRING 
G_FTEXT wie bei G_TEXT 
G_FBOXTEXT wie bei G_TEXT 


wie bei G_BOX 
wie bei G_TEXT 


wie bei G_BOX, aber Byte 3 enthält das darzustellende Zeichen 
Zeiger auf den String selbst 


e Zeichenroutine */ 
bei Aufruf der Zeichenroutine 
“ 





des Registers A4 das entsprechende 
andere Register nach regA4 schreiben; 
wer einen Compiler besitzt, der die glo- 
balen Variablen absolut adressiert, kann 
den EintragregA4 getrost komplett ver- 
gessen. Nach der Speicherreservierung 
für die APPLBLKSs folgt eine Zeile, die 
man vielleicht auch noch erklären soll- 
te, da sie auf den ersten Blick ziemlich 
dubios aussieht. Ich meine dabei fol- 
gende Zeile: 


submenu_index=submenu [submenu 


[submenu[0]..ob_tail]..ob_head] .ob_next; 


Wenn man sich gleichzeitig mit dieser 
Zeile aber noch die Abbildung 5 an- 
sieht, wird das Ganze vermutlich we- 
sentlich einfacher. Die Abbildung zeigt 
zwar den Menübaum und nicht den 
Baum für die Submenüs, aber Menülei- 
ste ist Menüleiste und hier soll es ja 
auch nur ums Prinzip gehen; nehmen 
wir also einfach mal an, der Baum in 
Abbildung 5 würde die Submenüs be- 
schreiben. In der oben genannten Zeile 
wird nämlich der Index der ersten Sub- 
menü-BOX im Submenübaum ermit- 
telt. Gehen wir einmal systematisch von 
innen nach außen vor: 


1.submenu[0].ob_tailzeigt aufdenrech- 
ten Teil des Menübaums und ergibt 
so die Indexnummer 6. 

2.submenu[0].ob_tail ersetzen wir nun 
durch diese Indexnummer und erhal- 
ten so als nächstes Konstrukt: 
submenu[6].ob_head. Das ist der lin- 
ke Pfeil zur BOX mit der Indexnum- 
mer 7. 

3.Wiederum eingesetzt erhalten wirjetzt 
submenu[7].ob_next und somit den 
Zeiger auf die Box für das erste Menü. 
Eigentlich ist es ja das zweite Menü, 
aber das erste muß übergangen wer- 
den, weil es sich dabei immer um das 
Deskmenü handelt! 


G_ICON Zeiger auf eine Struktur vom Typ ICONBLK, in der das Icon 
genauer beschrieben ist 
Zeiger auf den Text für den Menüeintrag 


Dieses gerade beschriebene Verfahren 
muß aus dem Grund angewendet wer- 
den, weil je nach Zahl der Menüs die 


G_TITLE 





Abb. 8: Die Bedeutungen von ob_spec 
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Für alle, die Daten verwalten müssen 
und nach eigenen Vorstellungen aus- 
drucken wollen. Ideal zum Ausfüllen 
vorgegebener und Erstellen eigener 
Formulare, perfekt für den Etikettendruck. 


Über 2000 PD-Diskeiten für ST/STE/TT 
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3,50 DM 
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FORMULAR plus | 


















1. Erotik 1 (s/w) (18) 16. Best of PD Die Komplettlösung für Datenverwaltung 
2. Erotik 1 (f) (18) 17. Drucker diabsolüt'paß Positionsdruck 
3. Spiele 1 (s/w) 18. Erotik 2 (s/w) (18) UNGF@BSSIUf DERGENAUEN EOSIKONSARUE 

4. Spiele 1 (f) 19. Erotik 3 (s/w) (18) Ausführliche Testberichte: 

Eineleiger Er on (18) ATARI-Journal‘ 10/91, ‘TOS’ 11/91, 'ST-Computer’ 12/91 

. Grafi . Spiele 

7. Clip-Art 1 22. Spiele 2 (s/w) 169 DM. . eine Versandkosten 

8. Clip-Art 2 23. Clip-Art 3 

9. Signum-Fonts 24. Erotik 3 (f) (18) Nachnahme: plus 5 DM, Ausland: plus 5 DM, nur Vorkasse 
1 n hs De Ein 5 Ihe Demo-Version mit vielen Musterdaten 10 DM, nur Vorkasse 
12. Lernp rog’amme 27. Finanzen Datenblatt mit ausführlicher Leistungsbeschreibung und 
1% DIL IEDFOOHAIRITG DR nee, t Anwendungshinweisen gegen frankierten Rückumschlag 
15. Geschäft 30. Spiele 4 (s/w) 
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Das neue universelle 2D/3D CAD-Programm 
: © DynaCADD 


für die bewährten universellen CRP-Digitizer: Bla et 


DynaCcADD Datei Setze Tools Bilder GCP 1.179332 Y 7.441280 Eigenschaften von DynaCADD: 


® Ausgereiftes 2D/3D-Konstruktionsprogramm in deutscher 
Sprache für allgemeine, professionelle Anwendungen 

® Einfache, leicht erlernbare und universelle Benutzeroberfläche: 
spart Lern- und Einarbeitungszeit! 

® Beinhaltet 10 professionelle Fonts und einen Fonteditor 

® Unterstützt Plotter, Matrix- und Laserdrucker und PostScript 

® DIN-gerechte, automatische und flexible 2D/3D-Bemaßung 

® Verwaltung von spezialisierten Symbolbibliotheken 





























































































































Kompatibilität: 

© DXF Ein-/Ausgabe 

® DEF (DynaCADD internes Format) Ein-/Ausgabe 
® GEM, HPGL/DMP, IMG, Encapsulated PostScript 


Applikationen/Einsatzgebiete: 








































































































DynaCADD ist derzeit erhältlich für: 
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Indexnummern völlig unterschiedlich 
sein können. Das sicherste Verfahren 
ist somit das Durchhangeln vom Wur- 
zelobjekt aus. 

Im weiteren passiert in init_submenus() 
eigentlich nichts Weltbewegendes 
mehr. In einer Schleife über alle Sub- 
menüs wird nach der Initialisierung der 
ext_appl_bik’s zuerst nach dem Index 
der Menübox gesucht, bei der irgend- 
wo ein Submenü herausklappen soll. 
Mit Hilfe des gefundenen Indexes wer- 
den dann die Koordinaten der Box er- 
mittelt und anschließend wiederum mit 
deren Hilfe die Koordinaten für die Box 
des Submenüs neu berechnet, denn 
das Submenü soll ja schließlich unmit- 
telbar neben dem Menü herausklappen 
und nicht irgendwo auf dem Bildschirm. 
Natürlich kann man durch Verändern 
der Koordinaten das Submenü auch 
sonstwo auf dem Bildschirm heraus- 
klappen lassen, beispielsweise links 
neben dem Menü. Platz für Spielereien 
gibt es hier genug, ob das Ganze dann 
aber noch sinnvoll ist, ist natürlich eine 
ganz andere Frage... Nach Beendigung 
der Schleife muß dann nur noch der 
Zwischenspeicher für den Submenü- 
hintergrund angefordert werden; um 
Speicherplatz zu sparen, wird dieser 
nicht für jedes Submenü angefordert, 
sondern nur für das größte. 

Damit wäre dann auch schon die Ini- 
tialisierung und Installation der Subme- 
nüs abgeschlossen, und den Restkann 
man getrost dem Betriebssystem über- 
lassen, esmeldetsich dannschon, wenn 
es etwas will, zum Beispiel ein Subme- 
nü zeichnen... 

In so einem Fall wird nämlich die in 
ob_spec eingetragene Adresse ange- 
sprungen und die Kontrolle anschlie- 
Bend der damit aufgerufenen Routine, 
in unserem Fall draw_submenuj), über- 
lassen. Und wehe, diese Routine arbei- 
tet nicht vernünftig... - die Effekte rei- 
chen von “Bildschirm-Allerlei” bis “ATA- 
Ri-Gardine”. 

Damit man bei Aufruf der Zeichenrou- 
tine aber nicht ganz allein, einsam, ver- 
lassen und sonstwie im Regen (bzw. 
Bombenhage)) steht, übergibt das Be- 
triebssystem netterweise jedoch noch 
einen Zeiger auf eine Struktur vom Typ 
PARMBLK (Parameter-Block), die wie 
in Abbildung 10 definiert ist. In Gedan- 
ken höre ich jetzt manche Leute stöh- 
nen: “Schon wiedereine Struktur!” aber 
in so einem Fall kann ich nur sagen: 
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GRUNDLAGEN 








typedef struct parm_blk 
t 
OBJECT *pb_tree; /* Zeiger auf den Objektbaum, der das 
benutzerdefinierte Objekt enthält */ 
int pb_obj; /* Indexnummer des Objekts #f 
int pb_prevstate; /* vorheriger Status, z.B. NORMAL */ 
int pb_currstate; /* neuer Status, z.B. SELECTED “ 
int pb_x; /* X-Koordinate des Objekts “ 
int pb_y; /* Y-Koordinate des Objekts */ 
int pb_w; /* Breite des Objekts er 
int pb_h; /* Höhe des Objekts R 
int pb_xc; /* X-Koordinate für das Clipping ur 
int pb_yc; /* Y-Koordinate für das Clipping “ 
int pb_wc; /* Breite für das Clipping ”f 
int pb_he; /* Höhe für das Clipping ” 
long pb_parm; /* übergebener Wert ub_parm aus der 
APPLBLK-Struktur “ 
} PARMBLK; 





Abb. 10: Definition der PARMBLK-Struktur 


“Leute, seid froh, daß Ihr keinen AMIGA 
besitzt, dort muß man sich selbst für 
einfache Textausgaben durch einen 
wahren Dschungel von Strukturen 


che! 

Mit Hilfe dieser PARMBLK-Struktur 
bzw. ihren Einträgen läßtsichdann auch 
schon eine ganze Menge anfangen, wie 
wir gleich sehen werden. Unter ande- 
rem kann man damit nämlich auch auf 
den APPLBLK zugreifen, von dem aus 
die Zeichenroutine aufgerufen wurde. 
Wenn parmblock der übergebene Zei- 
ger ist, dann enthält parmblock-> pb_- 
obj den Index des Menüeintrags, von 
dem aus die Routine aufgerufen wurde, 
parmblock->pb_tree einen Zeiger auf 
den Objektbaum (den Menübaum), und 
mit parmblock->pb_tree[parmblock -> 
pb_obj]. ob_spec erhält man dann den 
gesuchten Zeiger auf die APPLBLK- 
Struktur. Dieser Zeiger wirdimmer dann 
benötigt, wenn man die normale APPL- 
BLK-Struktur erweitert hat und Zugriff 
auf die restlichen (neuen) Einträge be- 


Vielleicht noch ein paar Anmerkungen 
zu den PARMBLK-Einträgen pb_- 
prevstate und pb_currstate: Wenn bei- 
de Variablen den gleichen Wert haben, 
muß das Objekt komplett gezeichnet 
werden, andernfalls ist nur der Status 
zu ändern. Erwähnenswert sind auch 
noch die Clipping-Koordinaten; sie ge- 
ben normalerweise den Bereich an, in 
den das Objekt gezeichnet werden soll, 
bei Aufrufen aus einem Menü heraus 
(wie hier) sind diese Koordinaten je- 
doch Null und dürfen deshalb nicht be- 
nutzt werden! 

Der jeweils erste Aufruf von draw_- 
submenu() geschieht in dem Augen- 
blick, in dem man die Maus in die Menü- 
leiste bewegt und dadurch das Menü 
herausklappt, denn auch das Zeichnen 
des völlig normalen Texteintrags im 
Menü muß jetzt selbst übernommen 
werden, da ob_spec ja nicht mehr auf 
den Text zeigt! Weiter muß in diesem 
Augenblick nichts getan werden. 

Erst wenn der Mauszeiger auf dem 
Menütext steht, wird draw_submenu() 








nötigt. erneut aufgerufen, denn in diesem Fal 

typedef struct fdbstr 

{ 
long fd_addr; /* Adresse des Speicherblocks “r 
int fd_w; /* Breite des Speicherblocks in Pixeln ii 
int fdh; /* Höhe des Speicherblocks in Pixeln “ 
int £fd_wdwidth; /* Breite des Speicherblocks in Worten “fr 
int fd_stand; /* 0 = Rasterkoordinaten (Standardform) 

1 = normalisierte Koordinaten (geräte- 
spezifische Form) “ 

int fä_nplanes; /* Anzahl der Farbebenen “ 
int fd_rl; /* reserviert “ 
int fd_r2; /* reserviert “r 
int £d_r3; /* reserviert “r 

} FDB; 











Abb. 11: Definition der MFDB-Struktur 


muß erstens der Eintrag selektiert und 
zweitens das Submenü gezeichnet wer- 
den. Zur Darstellung der Selektion wer- 
den die Objektkoordinaten aus dem 
PARMBLK ausgelesen und der Routine 
switch_entry() übergeben, die den Text 
mit einem schwarzen Balken übermalt. 

Bevor nun das Submenü gezeichnet 
werden kann, muß zuerst der Hinter- 
grund gerettet werden, wozu die VDI- 
Routine vro_cpyfm() benutzt wird. Hier 
an dieser Stelle eine Anmerkung dazu: 
Vielleicht ist jaschon jemandem aufge- 
fallen, daß in draw_submenu() inklusive 
aller Unterroutinen nirgendwo eine AES- 
Routine benutzt wird, und das darfauch 
auf keinen Fallgeschehen! Das AES hat 
nämlich den Nachteil, nicht reentrant zu 
sein, d.h. bei Aufruf einer AES-Routine 
aus dem AES heraus kommt es zu ei- 
nem wahren Bombenhagel; VDI-Routi- 
nen können dagegen ohne Einschrän- 
kung benutzt werden! 

Zurück zu vro_cpyfm(): Mit dieser Rou- 
tine ist es ziemlich einfach möglich, 
rechteckige Bildschirmbereiche in ei- 
nen zusammenhängenden Speicherbe- 
reich zu transferieren und umgekehrt, 
ohne daß man sich weiter um das unter- 
schiedliche Format kümmern müßte. 
Wenn ich dabei sage, “ziemlich ein- 
fach”, so meine ich damit nichts ande- 
res, als daß man mal wieder einige 
Strukturen initialisieren muß... 

Da vro_cpyfm() eine oft viel zu wenig 
genutzte Funktion ist, weil keiner weiß, 
wie er sie eigentlich genau zu benutzen 
hat, möchte ich hier an dieser Stelle 
genauer darauf eingehen. Die meisten 
Informationen zu diesem Thema sind 
übrigens in [1] zu finden, die ich hier, so 
wie sie in draw_submenu() benötigt 
werden, zusammengefaßt habe. 

Als erstes werden wieder einmal zwei 
Strukturen benötigt, und zwar diesmal 
vom Typ MFDB (Memory Form Defini- 
tion-Block), der laut Abbildung 11 defi- 
niert ist. Das Fehlen des M beiMFDB ist 
übrigens kein Fehler, sondern die Defi- 
nition lautet (seltsamerweise) wirklich 
so. 

Da die eine MFDB-Struktur ein Recht- 
eck auf dem Bildschirm beschreiben 
soll, nennen wir sie mal sinnigerwei- 
se screen, und die andere, die für einen 
Speicherbereich zuständig sein soll, 
dagegen memory. In der screen- 
Struktur brauchen wir lediglich den er- 
sten Eintrag zu initialisieren, nämlich 
fd_adar: 
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memory.fd_adär= (LONG)menu_buffer; 


memory.fd_wdwidth=sub_menu [sm_index] .ob_width/16+1; 


memory.fd_stand=0; 
memory.fd_nplanes=resolution ? 2/resolution : 4; 





screen.fd_adär=0L; 


Weitere Initialisierungen sind hier nicht 
notwendig. Das Betriebssystem erkennt 
bei Aufruf von vro_cpyfm() nämlich an 
der Null, daß die Struktur einen Bild- 
schirmausschnitt beschreibt und trägt 
dann an dieser Stelle automatisch die 
Adresse des Bildschirms ein und initia- 
lisiert auch die restlichen Parameter mit 
den richtigen Werten. 

Bei der memory-Struktur sind dage- 
gen schon einige Einträge mehr not- 
wendig: (Siehe Tab. 2). 

Menu_buffer ist die Adresse eines in 
init_submenus() angelegten Speicher- 
bereichs zur Zwischenspeicherung der 
Submenühintergründe und submenu- 
[sm_index].ob_width ist die Breite des 
Submenüsin Pixeln. Dajedoch die Breite 
in Worten, also 16 Bits, benötigt wird, 
ist die oben vorgenommene Umrech- 
nung notwendig. 

Fd_stand ist grundsätzlich Null bei 
Standard-, d.h. Rasterkoordinaten, die 
beim ST normalerweise benutzt wer- 
den, es sei denn, es wird zum Beispiel 
mit solchen Programmen wie GDOS 
gebootet, dann muß fd_stand eine 1 
enthalten. Leider reicht es jedoch nach 
meinen Erfahrungen in so einem Fall 
nicht aus, in fd_stand einfach eine 1 
hineinzuschreiben; ganz offensichtlich 
wären auch noch zahlreiche andere Än- 
derungen am Programm notwendig, 
deshalb funktioniert die abgedruckte 
Fassung nicht mit GDOS! 

Fd_nplanes muß die Anzahl der Bit- 
planes enthalten, die benutzt werden; 
in hoher Auflösung ist dies nur eine, in 
mittlerer Auflösung zwei und in niedri- 
ger Auflösung vier. Da Getrez() jedoch 
die Werte 2, 1 undOzurückgibt, müssen 
auch diese entsprechend umgerechnet 
werden. 

Wie man sieht, werden auch hier nicht 
alle Einträge der MFDB-Struktur initiali- 
siert; da man an vro_cpyfm() noch ein 
Feld mit den Quell- und Zielkoordinaten 
(copy_array) übergeben muß, ist dies 
auch nicht notwendig, weil einem das 
Betriebssystem mal wieder die halbe 
Arbeit abnimmt und die restlichen Ein- 
träge selbst initialisiert. Dabei enthalten 
copy_array[0] und copy_array[1] die 


Tab. 2 


Koordinaten der linken oberen Ecke und 
copy_array[2] und copy_array[3] die Ko- 
ordinaten derrechten unteren Ecke des 
zurettenden Bildschirmausschnitts. Für 
den Zielbereich kann auf Koordina- 
ten verzichtet werden, denn hierbei 
handelt es sich ja um einen fortlaufen- 
den Speicherbereich und zur späteren 
Restaurierung werden deshalb nur die 
Breite und Höhe des Ausschnitts benö- 
tigt. 

Damit sind alle Werte korrekt initiali- 
siert und einer Benutzung von vro_- 
cpyfm() steht nichts mehr im Wege. Um 
den Hintergrund wieder zu restaurie- 
ren, müssen lediglich die ersten vier 
Werte von copy_array mit den letzten 
vier Werten vertauscht werden. Und 
beim Aufruf von vro_cpyfm() müssen 
natürlich auch die letzten beiden Para- 
meter, also Quell- und Zieladresse, ge- 
wechselt werden. Dies macht übrigens 
die Routine redraw_bg(), die - wie oben 
schon erwähnt - mitunter auch vom 
Programmierer direkt aufgerufen wer- 
den muß. 

Nachdem jetztendlich der Hintergrund 
gerettet wurde (wurde auch langsam 
Zeit, lange hätte er bestimmt nicht mehr 
durchgehalten), kann das Submenüge- 
zeichnet werden. Anschließend werden 
dann die Texte hineingeschrieben, wo- 
bei die Flags CHECKED und DISABLED 
beachtet werden, denn üblicherweise 
wird doch nicht mehr benutzt. Wer un- 
bedingt noch Einträge haben will, die 
OUTLINED, SHADOWED oder sonst- 
was sind, soll gefälligst selber noch ein 
bißchen an draw_submenu() herumba- 
steln; ich bin von der Notwendigkeit 
jedenfalls nicht überzeugt, denn weni- 
ger ist oft mehr! 

Nach dem vollständigen Zeichnen des 
Submenüs kann jedenfalls draw_ sub- 
menu() auch schon wieder beendet 
werden, nur um bei der nächsten Maus- 
bewegung dann wieder aufgerufen zu 
werden... - aber das ist eine andere 
Geschichte. Erwähnen sollte ich wohl 
noch, daß der Status des Objekts, also 
NORMAL oder SELECTED, unbedingt 
wieder an das Betriebssystem zurück- 
gegeben werden muß, wenn man kein 
Chaos in den Menüs provozieren will! 
Der ganze Ablauf von draw_submenu() 
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ist noch einmal in Abbildung 12 als 
Struktogramm zu sehen. 

Kommen wir also zu der anderen Ge- 
schichte: Was passiert, wenn die Maus 
sich bewegt? Annahme: Sie wird von 
der Katze gefressen... Behauptung: 
falsch! Beweis: Wenn die Maus sich 
bewegt, wird sie ausgeschaltet (zumin- 
dest kurzfristig) und verschwindet so 
selbst für die guten Augen einer Katze... 
Aber von der Welt der Katzen und Mäu- 
se nun wieder zurück zur Welt der Mäu- 
se und Submenüs: Sobald die Maus 
bewegt wird, wird draw_submenu) er- 
neut aufgerufen; ist der Mauszeiger 
immer noch im gleichen Menüeintrag, 
passiert überhaupt nichts und die Rou- 
tine wird wieder verlassen. Hat der Zei- 
ger jedoch den Eintrag verlassen, muß 
zuerst überprüft werden, ob er sich in- 
nerhalb des Submenüs befindet; wenn 
ja, wird do_submenu() aufgerufen und 
übernimmt die Verwaltung des Subme- 
nüs. Andernfalls wird dasSubmenü wie- 
der “eingeklappt”, indem einfach der 
Hintergrund restauriert wird und an- 
schließend müssen dann nur noch der 
zugehörige Menüeintrag wieder norma- 
Iisiert und die Routine erneut verlassen 
werden. 

Jetzt stellt sich vermutlich nur noch 
eine Frage, die den geneigten Leser 
interessieren dürfte: Wie funktionuckelt 


draw_submenu() 








GRUNDLAGEN 


die Verwaltung eines Submenüs? Die 
Antwort: denkbar einfach. Betrachten 
wir uns also zu guter Letzt noch die 
Routine do_submenu(). Sie wird ausge- 
führt, solange sich der Mauszeiger in- 
nerhalb eines Submenüs befindet; ver- 
läßt die Maus auch nur einen Moment 
lang das Submenü, wird auch die Rou- 
tine verlassen und das Submenü wie- 
der eingeklappt. 

Gehen wir also davon aus, der Zeiger 
befindet sich innerhalb des Submenüs. 
Dann werden als erstes die Y-Koordi- 
naten aller Einträge mit der Y-Position 
des Mauszeigers verglichen, um her- 
auszufinden, über welchem Eintrag die 
Maus gerade “schwebt”. Wurde der 
Eintrag gefunden, wird er noch mit dem 
letztenangewählten verglichen, umfest- 
zustellen, ob die Maus einen neuen 
Eintrag angewählt hat. 

Wenn ja, muß der zuvor angewählte 
Eintrag normalisiert werden, sofern er 
nicht DISABLED ist, und anschließend 
wird dann der neu angewählte Eintrag 
selektiert. Jetzt fehlt nur noch die Über- 
prüfung, ob eine Maustaste gedrückt 
wurde, und falls ja, wird der Index des 
gerade angewählten Eintrags in sub- 
num übergeben und do_submenuf) ver- 
lassen. Dabei wird jedoch nicht auf eine 
bestimmte Maustaste getestet, so daß 
man innerhalb eines Submenüs auch 


do_submenu() 


die rechte Taste benutzen kann. Die 
ganze Routine ist im Überblick noch 
einmal in Abbildung 13 als Strukto- 
gramm zu sehen. 

So, und damit wäre ich so ziemlich am 
Ende angelangt, oder genauer gesagt: 
ganz am Ende (oder auch: fix und fer- 
tig). Jedenfalls sollte es jetzt so ziemlich 
jedem absolut klar sein, wie das Prinzip 
der Submenüs aussieht und wie man 
eigene benutzerdefinierte Objekte in 
Menüs anlegt. Und ich möchte ab so- 
fort keine Programme mit völlig überla- 
denen Menüs mehr sehen, wo doch 
jetzt Submenüs auch unter GEM mög- 
lich sind! Rein vom Prinzip her müßten 
Submenüs eigentlich auch auf GEM für 
PCs möglich sein; ich kann mir jeden- 
falls nicht vorstellen, daß man dort auf 
benutzerdefinierte Objekte verzichtet 
hat, aber auf diesem Gebiet kenne ich 
mich leider nicht so gut aus; das über- 
lasse ich gerne anderen. 
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Abb. 12: Struktogramm von draw_submenu() 
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Abb. 13: Struktogramm von do_submenuf() 
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Stunde 


schlägt ... 






Das neudeutsche Wort ‘Timer’ 
dürfte wohl jedem Computer- 
besitzer vom Hörensagen be- 
kannt sein; es bezeichnet ein 
elektronisches Bauteil, das 
nach Ablauf einer (hard- oder 
softwaremäßig) vorgegebe- 
nen Zeitdauer einen elektro- 
nischen Impuls aussendet. 
Wenn mansowill, istein Timer 
alsonichtsanderesalsein‘be- 
leuchtungsfreies Blinklicht’. 
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ieAnwendungsmöglichkeitenrei- 
D chen von der Meß- und Rege- 

lungstechnik bis hin zur elektroni- 
schen Tonerzeugung im Synthesizer. 
Was aber sucht dieses ominöse Teil im 
ST? Um diese Frage zu beantworten, 
müssen wir uns in den Alltag eines Be- 
triebssystems versetzen. Dieserbeginnt 
gewöhnlich mit dem Einschalten des 
Rechners, woraufhin das Betriebssy- 
stem naturgemäß seine Gemächer be- 
zieht, alle für den geordneten Betrieb 
notwendigen Systemvariablen und Pe- 
ripheriegeräte initialisiert und anschlie- 
Bend auf irgendeine Art und Weise dem 
Benutzer mitteilt, er könne jetzt mit sei- 
ner Arbeit beginnen. Startet dieser ein 
Programm, so gibt das Betriebssystem 
die Kontrolle an selbiges weiter und 
wartet darauf, daß es wieder aktiviert 
wird und den nächsten Befehl ausfüh- 
ren darf... In der Steinzeit der „Compu- 
ter’“ (vor etwa 20 Jahren), als die Bits 
noch in die Röhre schauten, da war das 
tatsächlich so. Aber heute würde jedes 
Betriebssystem, dasetwasaufsich hält, 
bei dem Vorwurf, bloß die Schnittstelle 


Timer und 
Interrupts 
im ATARI ST 


zwischen Mensch und Maschinezu sein, 
vor lauter Wut seine Arbeit einstellen. 
Bietet es dem geplagten Software-En- 
gineer (früher hieß das mal Program- 
mierer) doch eine ganze Menge Erleich- 
terungen: Wer kümmert sich um die 
Programmierung der Controller für die 
Peripherie? Wer um die Speicherplatz- 
verwaltung? Fensterln und ‘Mausen’ 
(rein grafisch natürlich!)? Kein Problem 
dank GEM & Co. Und schließlich die 
Krönung: Wie aus gut unterrichteten 
Kreisen verlautbarte, sollessogar Rech- 
ner geben, an denen mehrere Personen 
und sogar jeweils mehrere Programme 
gleichzeitig arbeiten können! Und wer, 
glauben Sie, organisiert dieses Chaos? 
Richtig: das Betriebssystem. Und das 
geht eben nur, wenn das System stän- 
dig die Kontrolleüber denRechner, sich 
selbst und natürlich über die Anwen- 
derprogramme hat. Wenn die Maschi- 
ne aber leider nur eine Ceh-Peh-Uh 
(nein, nicht Erzwo-Dezwo!) hat und die 
Kontrolle nur leichtfertig an ein Benut- 
zerprogramm abtritt: Wie soll ein Be- 
triebssystem dann in der Lage sein, die 








Wacht zu halten? Dazu braucht man 
Timer! Die nämlich machen den Pro- 
zessor inkurzen Abständen höflich, aber 
bestimmt, darauf aufmerksam, doch 
bitte wieder das Betriebssystem anzu- 
stoßen, damit Ordnung herrsche im 
Lande der Busse und Leiterbahnen. 
Doch nicht nur hier werden diese ‘Wek- 
ker’ gebraucht; im Prinzip lassen sie 
sich überall dort gewinnbringend ein- 
setzen, wo bestimmte Aufgaben peri- 
odisch ausgeführt werden müssen: vom 
Blinken des Cursors bis hin zum Über- 
prüfen von Tastatur und Floppy. 


Exceptions, Traps und 
Interrupts 


Nach diesem nicht allzu ernst gemein- 
ten Trip in die Welt der Betriebs-Soft- 
ware nun zum Trap, denn wir wollen ja 
wissen, wie diese Vorgänge realisiert 
werden. Eine der größten Stärken des 
68000er, so steht es geschrieben, sei 
seine Fähigkeit, Interrupts zu verwal- 
ten. In der Tat stehen dem System 256 
Vektoren zur Verfügung, die in Ausnah- 
mefällen dem Rechner und dem Be- 
triebssystem das Leben retten können! 
Im allgemeinen laufen Anwenderpro- 
gramme im sog. User(U)-Mode; hier 
sind einige der Maschinenbefehle nicht 
erlaubt, und auch innerhalb des Spei- 
chers gibt es ‘Sperrbezirke’, die für Pro- 
gramme tabu sind. Diese Maßnahmen 
sollen dazu dienen, das Betriebssystem 
gegen unbefugten Zugriff und damit 
gegen ‘Absturz’ zu schützen. 

Im MOTOROLA-Jargon ist alles, was 
die CPU in den Supervisor-Modus (S- 
Mode) versetzt, eine Ausnahme (engl.: 
exception). Das soll nicht etwa darauf 
hinweisen, daß so etwas selten vorkä- 
me, sondern darauf, daß irgendjemand 
irgendetwas vom Betriebssystem er- 
wartet, oder daß irgendwo irgendetwas 
irgendwie schiefgegangen ist. Genau- 
genommen muß man also zwischen 
zwei verschiedenen Exceptions unter- 
scheiden: den Traps, die prinzipiell von 
der Software explizit durch Befehl oder 
aber durch Laufzeitfehler (Division durch 
Null etc.) ausgelöst, und den Interrupts, 
die ausschließlich von der Hardware 
erzeugt werden. 

Im ST ist das bekanntermaßen so ge- 
löst, daß der Anwender mittels TRAP- 
Befehl die Funktionen des TOS anfor- 
dern kann, während er normalerweise 
mit Interrupts (Interrupt) überhaupt 
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nichts zu tun hat. Diese Arbeit über- 
nimmt glücklicherweise allein das Be- 
triebssystem. 


Von IPL ... 


Waskann denn nunalles einen Interrupt 
erzeugen? Z.B.: ein Monitorwechsel, 
volle Sende- und Empfangspuffer der 
diversen Schnittstellen, Floppy- und 
Harddisk-Controller und: die Timer! Was 
sich beim Auftreten einer Exception 
abspielt, wird in Bild 1 dargestellt. Zwei 
Ausnahmen bei den Ausnahmen: Beim 
Auftreten eines Bus- oder Adreßfehlers 
legt das Mikroprogramm der CPU noch 
ein paar Bytes mehr auf den Supervi- 
sor-Stack, um eine effektivere Post- 
Mortem-Analyse (Fehleranalyse nach 
Betriebssystemabsturz) zuermöglichen. 
Aber das nur nebenbei. Stellen wir uns 
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Tab. 1: 

Die 16 Interruptkanäle des MFP 68901: 
Kanal 0 besitzt geringste, Kanal 15 höchste 
Priorität 


ı.. (alte Daten) 


en 


zähler (PC) auf den 
Supervisorstack, geht in 
den S-Mode und springt 
anschließend in die 
Interrupt-Routine (IRR). 





nun vor, die RS232-Schnittstelle hätte 
beim Empfangen ‘den Kanal voll’ und 
könnte keine weiteren Daten mehremp- 
fangen. Bevor sie im Strom der Bits 
versackt, verursacht sie einen Interrupt, 
um damit die CPU davon zu überzeu- 
gen, daß ein Abholen der Daten wün- 
schenswert sei. In diesem Moment trifft 
das Ereignis eines Zeilenrücklaufes ein, 
das ebenfalls der CPU gemeldet wird. 
Aus einer Laune heraus schiebt der 
Benutzer die Maus ein paar Zentimeter 
über den Tisch und der Drucker be- 
kommt - nachdem er gerade ein Listing 
verdaut hat - wieder Hunger auf Daten. 
Wenn dann auch noch der Floppy-Con- 
troller die erfolgreiche Abarbeitung ei- 
nes zuvor abgesetzten Kommandos 
bekanntgibt, ist das Chaos perfekt. Die 
serielle Schnittstelle wurde zwischen- 
zeitlich ein Opfer der DFÜ, der Elektro- 
nenstrahl ist bereits wiederholt zurück- 
gelaufen, ohne daß es irgendjemand 
interessiert hätte, die Maus steht immer 
noch auf dem Papierkorb statt auf Disk 
A, der Drucker ist verhungert, und der 
Controller schmollt (in Anbetracht sol- 
cher Ignoranz!) neben dem Sound-Chip 
vor sich hin. Klarer Fall: So geht's nicht! 
Zwei Möglichkeiten bieten sich an: Ent- 
weder die CPU fragt im Ringelreihen 
(Round Robin-Verfahren) alle erdenkli- 
chen Interrupt-Quellen ab (Polling) und 
entscheidet dann von Fall zu Fall, ob 
eine Verarbeitung erforderlich ist, oder 
man gibt jeder Interrupt-Quelle eine Zahl 
mit auf den Weg, die angibt, wie wichtig 
ihre Wortmeldung, also die Interrupt- 
Anforderung (IRQ, Interrupt Request), 
ist; man nennt dies Prioritätensteue- 
rung. Im ST sind beide Formen reali- 
siert; der 68000er kennt aber nur das 
Prioritätenprinzip. Hierzu verfügt die 
CPU über die drei Eingänge IPLO, IPL1 
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und IPL2. Die Abkürzungen stehen für 
Interrupt Priority Level, also Unterbre- 
chungsprioritätenebene (bleiben wir 
doch lieber bei IPL ...). Tritt ein Inter- 
rupt-Ereignis ein, liegt die jeweilige Prio- 
rität an diesen Pins an. Die Bits 8 bis 10 
im Statusregister des Prozessors bil- 
den nun die Interrupt-Maske. Mit ihnen 
hat es folgende Bewandtnis: Steht die 
Maske z.B. auf 4, können nur Interrupts 
erkannt werden, deren Priorität größer 
oder gleich 4 ist. Setzt man diese Über- 
legung gewissenhaft fort, folgt hieraus, 
daß bei einer Maske von 0 alle Inter- 
rupts erlaubt sind, während eine 7 alle 
anderen Interrupts, außer der Stufe 7, 
sperrt. Da man Interrupts auf diesem 
Level nicht ausmaskieren kann, spricht 
man hier auch vom Non Maskable Inter- 
rupt (NMI). Im ST ist die Leitung IPLO 
permanent auf logisch ‘0’ gesetzt, so 
daß nur noch die Levels 2, 4 und 6 zur 
Verfügung stehen. 

Auf Stufe2 erscheint der HBL(Horizont 
Blank)-Interrupt. Wie oben bereits er- 
wähnt, ist er so unwichtig, daß man 
sich fragen darf, weshalb er der CPU 
überhaupt ‘Guten Tag’ sagen darf. Er 
entsteht bei jedem Zeilenrücklauf und 
hat sinnvollerweise die einzige Aufga- 
be, die Interrupt-Maske auf 3 zu setzen, 
um weitere HBL-Interrupts zu unterbin- 
den. Vergessen wir ihn also schnell wie- 
der. 

Die nächste beim ST erreichbare In- 
terrupt-Stufe ist 4. Hier meldet sich der 
VBL(Vertikal Bank)-Interrupt, und zwar 
bei jedem Bildrücklauf (1/70). ImST ist 
dann etliches zu tun: Test auf Monitor- 
wechsel, evtl. Veränderung der Auflö- 
sung und der Farbpalette, Blinken des 
Cursors, evtl. Ändern der Bildschirm- 
Anfangsadresse, Test auf Disketten- 
wechsel usw. Zwar kann man ohne grö- 
Beren Aufwand noch einige Routinen 
einflicken, aber schon rein aufgrund der 
zeitlichen Begrenzung steht fest, daß 
man hier nur kleinere Arbeiten ausfüh- 
ren lassen kann. 


„.. über den MFP ... 


Die höchste (ST-)Stufe ist 6. Hier resi- 
diert der MFP. Der MFP 68901 ist ein 
MehrFunktions-Prozessor(MFP), derim 
ST als Interrupt-Controller zum Einsatz 
kommt. Er kann 16 Interrupts erzeugen, 
die alle gegeneinander priorisiert sind, 
teilweise auch durch Polling abgefragt 
werden. Tabelle 1 zeigt eine Auflistung 
dieser Interrupt-Quellen. Für uns ist 
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genau eine dieser Quellen von beson- 
derer Bedeutung: der Timer A. Von den 
insgesamt 4 im MFP enthaltenen Ti- 
mern ist er der einzige, den man den 
Programmierern noch für eigene Zwek- 
ke gelassen hat; alle anderen dienen 
systeminternen Zwecken und müssen 
unangetastet bleiben, so man den Griff 
zum Reset-Knopf vermeiden möchte ... 


„.. zum Timer A 


Wie eingangs erwähnt, erzeugt ein Ti- 
mer periodisch Signale, die natürlich 
auch als Interrupt dienen können. Nun 
wäre das aber nur halb so interessant, 
wenn die Zeit zwischen zwei solchen 
Signalen nicht einstellbar wäre. Wir be- 


Wert: Vorteilung 


Timer aus 
4 

10 

16 

50 

64 

100 

200 


0 
1 
2 
3 
4 
5 
6 
: 





Tab. 2: 
Der Wert des Kontrollregisters bestimmt die 
Vorteilung von Timer A 


nötigen also schon einmal ein Datenre- 
gister. Einfacherweise wird der Wert in 
diesem Register kontinuierlich dekre- 
mentiert, bis er bei O angelangt ist. Just 
in diesem Moment soll ein Interrupt 
erfolgen und der Zähler wieder zurück- 
gesetzt werden. Abschalten muß man 
den Timer natürlich auch können; allein 
mit dem Datenregister ist das nicht 
möglich, denn selbst bei Eingabe einer 
0 wird solange dekremenetiert, bis wie- 
der die 0 kommt. Und das ist bei einem 
8Bit-Register nicht sehr lange. Man 
benötigt also noch ein Kontrollregister. 
Wir definieren (der MFP tut das im übri- 
gen genauso!) einen Timer als ausge- 
schaltet, wenn in seinem Kontrollregi- 
ster eine 0 steht. Ein von 0 verschiede- 
ner Wert aktiviert also den Timer; er 
erfüllt im MFP sogar noch einen weite- 
ren Zweck; je nachdem, welcher Wert 
gesetzt ist, müssen entsprechend viele 
Taktsignale am MFP ankommen, bis 
der Wert im Datenregister dekremen- 
tiert wird (Vorteilung!), oder die Betriebs- 
art des Timers wird geändert (Count 
And Jump - also so wie oben - oder 


Zählen externer Impulse bzw. von de- 
ren Länge). Die letzten beiden Modi 
sind für uns uninteressant, weil sie vor- 
ab den Gebrauch eines Lötkolbens vor- 
aussetzen; für den ersten Modus steht 
in Tabelle 2 der Vorteilungsfaktor in 
‚Abhängigkeit vom Inhalt des Kontroll- 
registers. 

Jetzt können wir also den Timer ein- 
und ausschalten. Damit der MFP aber 
überhaupt weiß, daß, was da aus Rich- 
tung Timer ankommt, auch ein Interrupt 
ist, müssen wir ihm das explizit beibrin- 
gen, und zwar, indem wir in einem wei- 
teren Register (Interrupt-Enable) ein Bit 
setzen. Nein, nicht irgendeines; die 
Nummer 5 muß es sein, denn nur sie 
schaltet den Timer A zum MFP durch! 
Die XBTIMER()-Funktion setzt dieses 
Bit automatisch; programmiertman von 
Hand zu Fuß, gilt; vergißt man dieses 
Detail, empfehlen sich Baldriantropfen 
zur Beruhigung ... 

Eine weitere Besonderheit, die es zu 
beachten gilt: Wird im MFP ein Interrupt 
erzeugt (egal durch wen), wird das zum 
Verursacher gehörende Bit im Interrupt- 
Service-Register gesetzt. Dadurch wer- 
den alle Interrupts niedriger Priorität 
ausmaskiert, also nicht mehr erkannt. 
Aus Gründen des Fairplays gebietet es 
sich, das besagte Bitnach Beenden der 
Interrupt-Routine (IORR) wieder auf O 
zu setzen! Für den Timer A ist wieder 
das Bit 5 zuständig. Zwar könnte man 
jetzt noch alle sonstigen Möglichkeiten 
und Eigenschaften des MFP erklären, 
aber das würde zu weit führen. Nur 
noch eins: Die Vektoren, über die beim 
Auftreten eines Interrupts des MFP ge- 
sprungen wird, stehenab Adresse $100. 
Man erhält die Adresse des Vektors 
eines Interrupts durch Addition des Vier- 
fachen der Interrupt-Nummer zu die- 
sem Offset. In Tabelle 3 sind alle für die 
Programmierung des Timers A notwen- 
digen Register und deren Adressen 
angegeben. 

Zur besseren Demonstration program- 
miert das Beispielprogramm den Timer 
A so, daß durch häufig auftretende In- 
terrupt-Anforderungen soviel Rechen- 
zeit von der CPU ‘abgegraben’ wird, 
daß für die Ausführung des eigentlichen 
Benutzerprogramms schlimmstenfalls 
nichts mehr übrigbleibt: der ST steht 
still! Da die Bedienung aus dem Pro- 
grammkopf hervorgeht, widmen wiruns 
nun den heiklen Seiten der Interrupt- 
Programmierung. 


Rien ne va plus ... 


Nicht besonders witzig ist folgende Si- 
tuation: Keine Bomben, die Maus rea- 
giertwiegewohnt, das Desktop erstrahlt 
im vollen Glanz ... Aber beim Auswählen 
der Drop-Down-Menüs in der Menü- 
Zeile tut sich nichts mehr, und die Ta- 
statur hat in GEM-Programmen sowie- 
so nicht viel zu melden. Diagnose: Das 
AES ist abgeschossen worden, jener 
Teil des GEM, der sich so fürsorglich 
um Menüs, Dialoge und Fenster etc. 
kümmert. Da hilft nur ein Reset (und 
manchmal nicht einmal der ...). Trat 
dieser Fauxpas in Zusammenhang mit 
der Timer-Programmierung auf, war 
unter Garantie die Blockierung anderer 
Interrupts der Sündenbock. Man muß 
sich eins vor Augen halten. Der MFP 
erscheint mit seinem Interrupt auf der 
für die CPU höchsten Prioritätsstufe. 
Damit wird durch Eintreten eines Inter- 
rupts an diesem Baustein automatisch 
der VBL-Interrupt blockiert, weil dieser 
auf Level 4 arbeitet und der Prozessor 
die Interrupt-Maske auf den aktuellen 
Interrupt-Level setzt; will heißen: Wenn 
der MFP einen Interrupt auf den Bus 
legt, setzte der 68000er die Interrupt- 
Maske sofort auf 6! Da im ST dies die 
höchste Stufe ist, werden bis zum Zu- 
rücksetzen der Maske auf die vorher 
eingestellte Stufe nur Interrupts vom 
MFP bearbeitet. Zum zweiten ist der 
Timer A auch innerhalb des MFP auf 
sehr hohe Priorität gesetzt: Vorihmran- 
gieren nur noch zwei weitere Interrupt- 
Quellen: Ri(Ring Indicator), der nur bei 
angeschlossenem Modem von Bedeu- 
tung ist, und Monochrome Detect. Wer 
nicht permanent an seinem Monitor- 
stecker herumspielt, hathierauchnichts 
zu befürchten. Ergo: Wenn Timer A in 
Aktion tritt (einen Interrupt auslöst), sind 
alle anderen Interrupts ausmaskiert! Die 
oberste Pflicht einer eigenen Timer- 
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Routine muß also sein, gleich am An- 
fang alle Interrupts wieder freizugeben; 
schließlich wollte man ja nur die Pro- 
grammkontrolle haben. Es muß des 
weiteren darauf geachtet werden, daß 
die VBL-Interrupt-Routine unter keinen 
Umständen abgebrochen wird, weilhier 
vorwiegend sehr kritische Dinge pas- 
sieren, die keinen Aufschub dulden. Ob 
man diese Routine unterbrochen hat, 
kann man an Bit 10 des Statusregisters 
ablesen, das ja der Prozessor auf den 
Stack abgelegt hat. Ist dieses Bit (IPL2) 
gesetzt, d.h. steht mindestens auf 4, 
empfiehlt sich ein beschleunigtes Ver- 
lassen der Interrupt-Routine! Ebenfalls 
zu beachten: Da man vielleicht nicht 
weiß, wie lange man in der Interrupt- 
Routine bleiben wird, empfiehltsich das 
sofortige Ausschalten des Timers, weil 
sonst ein erneuter Interrupt auftreten 
könnte [Interrupts mit höherer oder glei- 
cher(!) Priorität sind ja weiterhin zuge- 
lassen] und man mit demaltennoch gar 
nicht fertig ist ... Am Ende der Routine 
muß man den Timer dann wieder neu 
programmieren. Der nächste wichtige 
Punkt: die Floppy bzw. Harddisk. TOS 
setzt an der Adresse $43E beim Betre- 
ten einer Floppy-Routine ein Semapho- 
re und will damit sagen, es möchte jetzt 
nicht gestört werden. Also müssen wir 
auch in diesem Fall unsere Zelte vorzei- 
tig abbrechen. Nur wenn diese Spei- 
cherzelle O enthält, dürfen wir loslegen, 
sonst liefert die Floppy Daten, die das 
Betriebssystem noch gar nicht verar- 
beiten kann (Wirkung: Daten auf Disk A: 
defekt? Bitte überprüfen Sie ...)! Schließ- 
lich noch ein wichtiger Punkt: Man darf 
in der Timer-Routine fast alles anstel- 
len, aber eines ist unter Absturzgefahr 
verboten: das Aufrufen des Betriebssy- 
stems über den TRAP-Befehl! Der Grund 
hierfür liegt darin, daß man u.U. eine 
Betriebssystemfunktion unterbrochen 
hat, und bei einem zweiten Aufruf aus 


$FFFA19 
$FFFAIF 
$FFFAO7 


$FFFAOF 
SFFFAOB 
$FFFA13 





Kontrollregister, bestimmt Timerfunktion 
Datenregister, Dekrement-Offset 
IR-Freigabe (Bit 5) 

Zeigt aktiven IR an (Bit 5) 

Bit 5 ist bei Timer A-IR gesetzt 
IR-Maske (Bit 5) 


Tab. 3: Überblick über die für den Timer A wichtigen Register. TREA und IRMA werden von 
XBTIMER() automatisch gesetzt. IRPA (Bit 5) zeigt einen ”"hängenden” Timer-Interrupt an; 


ein Rücksetzten ist nicht unbedingt notwendig. 


der Interrupt-Routine würde man die 
geretteten Register etc. des unterbro- 
chenen Programmesüberschreiben (die 
Trap-Handler sind nicht reentrant)!!! Es 
gibt nur zwei Möglichkeiten für einen 
Betriebssystemaufruf aus einer Inter- 
rupt-Routine: Entweder man ruft die 
gewünschte Funktion direkt auf (Para- 
meter auf den Stack legen, dann JSR 
..), oder man schreibt sie sich selbst. 
Der letztere Fall ist der ‘saubere’ und 
meist auch der zeitgünstigere, da man 
nur die Teile einer Routine neuschreibt, 
die man auch benötigt. 


Ihr Einsatz, bitte! 


So schön ein sich in Super-Zeitlupe 
aufbauendes Fenster auch sein mag 
(probieren Sie es mit dem Demopro- 
gramm doch einmal aus ...): sicherlich 
gibt es wesentlich sinnvollere Anwen- 
dungen für einen Timer. Zwei davon 
möchte ich Ihnen kurz als Anregung 
vorstellen. Da wäre zunächst die Imple- 
mentation eines Spoolers (Simultaneous 
Peripheral Operartion On Line, was zu 
deutsch soviel bedeutet wie: Parallele 
Ausführung von Ein- und Ausgabe), die 
es erlaubt, alle Druckerausgaben im 
Hintergrund ablaufen zu lassen, also 
ohne Wartezeit für den Benutzer. Dazu 
benötigen wir Speicherplatz zur Zwi- 
schenablage des zu druckenden Doku- 
ments. (Man kann natürlich das ganze 
auch dynamisch mit einer Zwischenab- 
lage auf Festplatte oder Diskette auf- 
bauen.) Zwei anzulegende Pointer ver- 
weisen auf die aktuelle Schreib- und 
Leseposition innerhalb des Puffers. Statt 
die Daten direkt an den Drucker zu 
geben, werden sie in den Puffer (auf 
Platte) geschrieben und der Schreib- 
pointer entsprechend erhöht. Ist der 
Puffer voll, wird wieder beim ersten Byte 
des Puffers weitergeschrieben, wobei 
man beachten muß, daß die aktuelle 
Leseposition nicht überschritten wird 
(Turn-around). Über den Timer A (oder 
eine andere Interrupt-Quelle) steuern 
wir nun eine Interrupt-Routine an, die 
überprüft, ob der Puffer noch auszuge- 
bende Daten enthält (Schreibposition > 
Leseposition, Überlauf beachten!). Ist 
dies der Fall, wird pro Interrupt 1 Byte 
mit einer eigenen Routine an den Druk- 
ker geschickt (oderüber das TOS, siehe 
aber oben!) und der Lesezeiger inkre- 
mentiert. Fertig! 

So einfach wie der Spooler ist die 
zweite Anregung nicht mehr: Multitas- 
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king heißt die Devise. Ein wenig seltsam 
ist der 68000er ja schon: Da stellt er 
einerseits dem Systemprogrammierer 
einen mächtigen Semaphore-Befehl 
(TAS adr) zur Verfügung, der im Multi- 
tasking-Betrieb sicherstellen kann, daß 
immer nur ein Prozeß auf einen kriti- 
schen Bereich zugreifen darf, und ist 
anderseits nicht dazu in der Lage, einen 
doppelten Busfehler zu beheben: Ge- 
ben Sie mal im Supervisor-Modus den 
Befehlmove.b d0,-(a7). Wenn sich dann 
noch irgendetwas rührt, empfehle ich 
das Aufschrauben des Gehäuses 
zwecks Überprüfung, ob da auch wirk- 
lich ein 68000er seinen Dienst versieht 
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... Trotzdem läßt sich bei sauberer Pro- 
grammierung das quasiparallele Aus- 
führen von Prozessen erreichen. Es 
würde Bände füllen, auf alle Besonder- 
heiten und Eventualitäten beider Imple- 
mentation einzugehen, deshalb hier nur 
ein paar allgemeine Hinweise: Jeder 
der parallelen Prozesse benötigt eigene 
Stacks (für User- und Supervisor-Mo- 
dus). Der Dispatcher, also der Prozeß- 
Umschalter, muß bei einem Jobwech- 
sel die Register des aktuellen Prozes- 
ses retten und die des nächsten laden. 
Alle Trap-Handler müssen mit einem 
Semaphore ausgestattet werden, der 
von einem Prozeß vor Eintritt ins Be- 


triebssystem abgeprüft wird (TAS-Be- 
fehl!). War er gleich Null, wird er auf -1 
gesetzt, und der Prozeß darf die Routi- 
ne aufrufen, sonst muß er gewartet 
werden, bis der Job, der sich gerade im 
Betriebssystem befindet, den Sema- 
Phore wieder auf Null gesetzt hat (Dies 
muß genau vor RTE, also dem Rück- 
sprung ins Programm, erfolgen). Was 
sonst noch getan werden muß, hängt 
ganz davon ab, welche Forderungen 
man an das System stellt; hier sind also 
Ihre Phantasie und Intuition gefragt! Wie 
man sieht, kann man mit Timern und 
Interrupts eine ganze Menge anstellen. 
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Festplatten 
TAS-FILE - Die überzeugende 
Festplattenlösung für den Atari 
STITT. Leise, schnell und kom- 
plett in der Ausstattung. Aus- 
wahl der Acc’s und Autoord- 
ner-Programme beim Booten, 
abschaltbarer Hostadapter, ex- 
terner SCSI-Bus, stabiles Ge- 
häuse in MEGA-ST Maßen, 
’Low Power’ Laufwerke von 
Quantum ohne Lüfter (außer 
425) - deshalb besonders leise 
und in der PLUS-Ausstattung 
zusätzlich: 

Argon - hochkomprimierendes 
Backup-Programm mit komfor- 
tabler Batchsteuerung für die 
Sicherheit Ihrer Daten. 

Crypton - Festplattendienst- 
programm zur Behebung der 
Dateizerstückelung - dadurch 
schnellerer Zugriff, wiederher- 
stellen versehentlich gelöschter 
Dateien. 
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rufbeantworter. Wenn Sie Fra- 
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fach Ihre Telefonnummer - wir 
rufen Sie zurück. 


598.- 


Keine Versandkosten. Alle Prei- 
se in DM. Änderung, Irrtum 
vorbehalten. Technische Anga- 
ben sind Herstellerangaben. 


TORSTEN ANDERS SOFTWARE 
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Grafikroutinen 


Der Programmierer findet im VDI des ST/TT bereits eine Reihe von Grafikfunktionen, die ihm das Leben leichter 
machen. Ob es ums Linienziehen, Rechteckzeichnen, Rechteckfüllen, Text- oder sogar Sprite-Ausgabe geht, ein 
VDI-Aufruf und die Funktion wird vom Betriebssystem übernommen. Leider handelt es sich bei den Routinen 
jedoch ‘nur’ um die einfachsten Grafikroutinen. Eine Möglichkeit zum Zoomen sucht man vergebens. Um Ihnen 
das Leben beim Programmieren von Grafikanwendungen noch ein wenig leichter zu machen, finden Sie nachfol- 
gend weitere Grundfunktionen für Ihre Grafikbibliothek. Viele Routinen stehen hier, wie auch bei den übrigen 
Rubriken dieses Sonderhefts, in drei Sprachen zur Verfügung (C, PASCAL und BASIC). Aus Geschwindigkeits- 
gründen haben wir einzelne Routinen in Assembler belassen. Diese können Sie jedoch durch Aufruf auch in 
Ihrer Programmiersprache nutzen. 


Scrollen in alle Richtungen 
für verschiedene Bildschirmbereiche bietet 


die Routine:auf Sälte......0...e0.niennsen 82 
Skalierung 

Einfache Erzeugung von Achsen und Achsenkreuzen 
inklusive automatischer Beschriftung ..............2.4.40000.0- 83 


Schnelle und variable Textausgabe 
in beliebiger Größe und unter jedem Winkel, unter Ver- 
wendung eigener Zeichen ...........20z2u2s202202020000nnennennnnnn 84 


Cursor an GEM-Textattribute anpassen 
Textein- und ausgabe in verschiedenen Winkeln unter 
Verwendung aller GEM-Textattribute .............. 85 


Geglättete Polygonzüge 
Das Aussehen der Polygonzüge wird durch 
Interpolation verbessert...........u.uussn0ss0nnonnnnensonnnnennnnnnnnene 86 


Schönere Kreise 
Eine Implementierung des Horn-Algorithmus ............... 87 


Überblendeffekte 
für Vorführungen, den Programmvorspann 
oder sonstige Gelegenheiten ..........seressssssosesneenenenenenn 88 


Fastzoom 
eine schnelle Zoom-Routine sollte in keinem 
Grafikprogramm fehlen... 





Kopieren und Verschieben variabler Bildausschnitte 
werfen Sie Ihre Schere und den Klebstoff weg .. „91 





Lasso-Funktion 
wenn Sie beim Bearbeiten von Grafiken einen nicht 
rechteckigen Ausschnitt ‘ausschneiden’ müssen, ver- 


wenden Sie doch unsere Routine ..........2.22u22022202002000.> 92 
Schnelle UNFILL-Routine 

zum ‘Aus’füllen von Grafikbereichen .........................0..+ 94 
Radieren 

zum ‘Wegwischen’ von Falschzeichnungen ................. 95 
Farbpalette 


Grundlagen zur Animation durch Wechsel 
dar, Farbpalettentsr:. est rer 98 
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Scrollen 
in alle 
Richtungen 


Eine Scroll-Routine muß, damit der Bildauf- 
bau nicht ruckartig wird, möglichst schnell 
arbeiten. Eine Programmierung in Assembler 
ist deshalb unumgänglich. Außerdem muß die 
Parameterübergabe so einfach wie möglich 
ausfallen, da auch dies die Routine verlang- 
samt. Die hier vorgestellte Scroll-Routine be- 
nötigt als Parameter nur einen Zeiger auf eine 
Struktur, der sie dann alle benötigten Daten 
entnehmen kann. 


Ulrich Witte 


amit entfällt eine weitere Einschränkung: werden näm- 
D lich direkt in der Routine Werte geändert (auch eine 

Möglichkeit, um Übergabeparameter zu sparen ...), 
braucht man für jeden zu scrollenden Block eine eigene 
Routine, bzw. es müßte jedesmal die Initialisierungsroutine 
aufgerufen werden, wenn ein anderer Block gescrollt werden 
soll, was nicht besonders zur Geschwindigkeitssteigerung 
beiträgt. 

Die Struktur besteht aus folgenden Komponenten: words 
enthält die Wörter (16 Bit) pro Zeile, zeilen die Zeilenzahl, 
beide um 1 erniedrigt. offset enthält die Breite in Bytes, wird 
zur Korrektur des an der abzuarbeitenden Zeile langlaufen- 
den Zeigers benötigt, adr ist die Adresse auf dem Monitor, 
pixel die Breite in Pixeln (wird nur für Links-rechts-Scrollen 
benötigt). 

Den Scroll-Routinen wird neben dem Zeiger auf diese 
Struktur ein Wert für die Pause übergeben, die nach jeder 
Zeile beim vertikalen bzw. nach jedem Pixel beim horizonta- 
len Scrollen gemacht werden soll, die Zahl der Zeilen bzw. 
Pixel, die pro Aufruf der Routine gescrollt werden sollen, und 
ein Flag für die Richtung. Die Pause verlangsamt das Scrollen 
absolut, auch für die andren zu scrollenden Bereiche, wäh- 
rend die Pixel-Angabe das Scrollen des einen relativ zu den 
anderen Bereichen ändert. So kann z.B. ein Block bei jedem 
Durchlauf 4 Pixel scrollen, während die anderen nur 1 Pixel 
pro Durchlauf scrollen dürfen. 
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Die Routine scrollinit errechnet die für das Scrollen nötigen 
Parameter. Zu beachten ist, daß das Flag, das die Richtung 
bestimmt, den gleichen Wert haben muß wie beim Aufruf der 
Scroll-Routinen, dasonstfalsche Bereiche gescrollt werden. 
Es findet keine Überprüfung auf negative Werte statt, die 
entstehen, wenn man das zweite x/y-Koordinatenpaar klei- 
ner angibt als das erste; also Vorsicht! 

Im (Assembler)Source sind an einigen Stellen Pfeile (==>), 
die deutlich machen, wo die Routinen an die Bildschirmbreite 
angepaßt werden sollten, damit wenigsten monochrom auf 
größeren Bildschirmen gescrollt werden kann. 

Die Routinen sind so geschrieben, daß sie ohne globale 
Zugriffe auskommen, es müssen nur die beiden Strukturen 
vereinbart werden, was je in einer Header-Datei geschehen 
kann. Extra compiliert braucht man das File dann nur noch 
hinzuzulinken. Natürlich sind die Routinen weniger geeignet, 
wenn es darum geht, den ganzen Bildschirm zu verschieben. 
Die wortweise Schleife ist dann einfach zu langsam. Für 





Aufruf: 
Funktion: 
Parameter: 


scrollinit(k, scroll, lo) 
initialisiert eine Scroll-Struktur 
k: Zeiger auf eine Rechteckstruktur; enthält 
die beiden gegenüberliegenden Eckpunkte 
scroll: Zeiger auf Scroll-Struktur 
lo: 0: setzt Startzeiger auf Ende des 
Rechtecks (rechtes unteres Eck); für Scrol- 
len nach rechts oder unten 
1: setzt Startzeiger auf Anfang des 
Rechtecks (linkes oberes Eck); für 
Scrollen nach links oder oben 


Aufruf: 
Funktion: 


scroll_Ir(scroll, warten, pixel, richtung) 
scrollt Bildschirmbereich nach rechts oder 
links 
Parameter: scroll: Zeiger auf Scroll-Struktur 
warten: Pausenlänge nach Scrollen 
pixel: Anzahl der zu scrollenden Pixel 
richtung: 0: rechts 

1: links 


Aufruf: 
Funktion: 





scroll_ou(scroll, warten, pixel, richtung) 

scrolit Bildschirmbereich nach oben oder 

E unten 

Parameter: scroll: Zeiger auf Scroll-Struktur 

warten: Pausenlänge nach Scrollen 

pixel: Anzahl der zuscrollenden Pixel-Zeilen | 

richtung: 0: unten 
1: oben 
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kleinere Bereiche (und dann auch gerne mehrere) lassen sich 
aber doch recht flüssige Bewegungen erzielen. 

Besondere Effekte erzielt man beim Übereinanderlegen 
von scrollenden Blöcken. Rechts + Oben = Diagonal, das ist 
ja wohl klar; überkreuzen sich z.B. 2 Blöcke, die in die gleiche 
Richtung scrollen, wird der überlappende Bereich auseinan- 
dergezogen, scrollen sie entgegengesetzt, scheint der 
Schnittpunkt stillzustehen. Weisen die beiden auch noch 
unterschiedliche Geschwindigkeiten auf, läuft der Schnitt- 
punkt plötzlich spiegelverkehrt! Ein nettes Feld zum Experi- 
mentieren ergibt sich auch, wenn 2 senkrechte und 2 
waagrechte ‘Stäbe’ so eingestellt sind, daß die Pixel im Kreis 
(bzw. im Rechteck) laufen. 


Skalierung 


Stellen Sie sich vor, Sie haben ein Programm 
geschrieben, das Formeln auswertet und das 
Ergebnis grafisch darstellt. Leider haben Sie 
jedoch außer einem einfachen Achsenkreuz 
keine weiteren Bezugslinien. Wenn Sie die 
Grafik betrachten, wüßten Sie gerne, welchen 
Wert (in etwa) die Kurve an einer bestimmten 
Stelle hat. Wie wäre es denn dann mit einer 
Beschriftung Ihres Achsenkreuzes (oder Ihrer 
Skalen)? 


ie haben zwei Möglichkeiten, das zu verwirklichen. 
S Zum einen können Sie eine Routine dafür schreiben, 

oder aber Sie verwenden unser ‘Achsenkreuz’. Mit 
dieser Routine können Sie beliebige Skalen und Achsen 
zeichnen, beschriften und, wenn Sie wollen, auch mit einem 
Raster unterlegen lassen. Ihr Programm muß dann ‘nurnoch’ 
die Kurve(n) eintragen. Wäre das nicht was ...? 

Unsere Routine Achsenkreuz benötigt zum Arbeiten den 
Bereich, innerhalb dessen das Achsenkreuz erscheinen soll, 
die maxi- und minimalen Wert für die x- und y-Achse, die 
Angabe, ob mit oder ohne Kasten, und einen Wert für das 
Raster. Diese Routine ruft ihrerseits ein Unterprogramm auf, 
das die einzelnen Achsen zeichnet. Sollten Sie in einer 
Anwendung nur Achsen benötigen, können Sie diese Routi- 
ne verwenden. Sie benötigt folgende Parameter: Start- und 


Eine ‘ernsthafte’ Anwendung ist z.B. eine Laufschrift, wie im 
Beispielprogramm. Vielleicht kommt ja mal jemand auf die 
Idee, wichtige Alert-Boxen mit scrollenden Stopschildern 
auszustatten? Die werden dann bestimmt nicht mehr über- 
sehen! 

Beim Demo sind einige Tasten des Zehnerblocks belegt: ‘+’ 
und ‘-’ erhöhen bzw. erniedrigen die relative Geschwindig- 
keit der horizontalen Schrift, “ und ‘/’ die der vertikal 
scrollenden Schrift, ‘(‘ und ‘)’ erniedrigen/erhöhen die abso- 
lute Geschwindigkeit (Pause). Enter setzt die Parameter 
zurück, und mit ESC können Sie das Programm verlassen. 


Endpunkt der zu zeichnenden Achse sowie Start- und End- 
punkt der anderen Achse (wird für Raster benötigt), Anfangs- 
und Endwert der Skalierung, die Ausrichtung und einen Wert 
fürs Raster. 





Aufruf: Achsenkreuz(Xl,Xr,Yu,Yo,Xmin,Xmax, 
Ymin, Ymax,Kasten,Raster) 
zeichnet Achsenkreuz mit Skalierung; nach 
Wahl Unterteilung innerhalb des Achsen- 
kreuzes 
Parameter: XI, Xr: Pixel-Wert der linken und rechten 
Kante 
Yu, Yo: Pixel-Wert der unteren und oberen 
Kante 
Xmin, Xmax: mini- und maximaler Skalen- 
wert für x-Richtung 
Ymin, Ymax: mini- und maximaler Skalen- 
wert für y-Richtung 
Kasten: O nur Achsenkreuz, 1 auch Kästen 
Raster: 0 kein Raster, sonst Rasterbreite in 
4er-Pixeln 


Funktion: 





Aufruf: Achse(beg, end, beg2, end2, min, max, x_y, 

Raster) 

zeichnet Achse mit Skalierung, Rasterunter- 
teilung innerhalb der Achsen möglich 

beg, end: Koordinaten des Anfangs- und 
Endpunktes der Achse (nur x- oder y-Wert) 

beg2, end2: Anfangs- und Endpunkt der 
anderen Achse 

min, max: mini- und maximaler Wert der 
Skalierung 

x_y: Ausrichtung der Achse (>0 y-Achse, <O 
x-Achse; Beschriftung: 1 rechts, 2 links, -1 

über und -2 unter der Achse) 

Raster: O0 kein Raster, sonst Rasterbreite in. 
4er-Pixeln 


Funktion: 


Parameter: 
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Schnelle 
und variable 
Textausgabe 


Um eine schnelle Textausgabe zu erreichen, 
wurden die dazu notwendigen Routinen in 
Assembler geschrieben. Sie können aus jeder 
beliebigen Hochsprache heraus aufgerufen 
werden. 





M. Malich/E. Grah 


in Beispiel dafür befindetsich auf der Diskette. Den von 
E diesem Programm ausgegebenen Text können Sie 

durch Bewegungen mit der Maus verschieben, durch 
Drücken der Maustasten verkleinern und vergrößern und mit 
Hilfe der ‘+’- und ‘-'-Taste drehen. 


Das Maschinenprogramm besteht aus 4 Teilen: 


1. der Initialisierung, in der eine Tabelle berechnet wird, die 
einen schnellen Zugriff auf die Daten jedes einzelnen 
Zeichens ermöglicht 

2. einer Routine zur Einstellung der Ausgabeparameter (Zei- 
chenfarbe, Maske für den Linienstil und Grafikmodus) 

3. einer Routine zur Einstellung der Textparameter (Sinus 
und Cosinus des Drehwinkels, Kursiv-Parameter, Größe 
in x- und y-Richtung) 

4. der eigentlichen Textausgabe. 


Die Adressen zu den einzelnen Routinen liegen am Anfang 
des Assembler-Programms [INIT_POINTER bei Byte 0, 
SET_PARAMETER bei Byte 4, SET_COLOR Byte 8, und 
TEXT_OUT ab Byte 12 ($0B)]. 

Zur einfachen Handhabung der Zeichen sind sie als Poly- 
gonzüge in einer 20*40-Matrix definiert. Die Tabelle ist dabei 
folgendermaßen aufgebaut: Zu Anfang steht der ASCII-Code 
des jeweiligen Zeichens, anschließend folgt ein Polygonzug. 
Beginnend mit derx/y-Koordinate der Startposition folgt eine 
Liste von (x/y-) Vektoren. Zwei Null-Bytes kennzeichnen das 
Ende eines Polygonzuges. Das Ende der Polygonzüge eines 
ASCII-Zeichens wird durch ein auf zwei Null-Bytes folgendes 
$FF gekennzeichnet. 

Bei Manipulationen an den einzelnen Zeichen braucht man 
sich nun nicht um jeden einzelnen Punkt des Zeichens zu 
kümmern. Die Berechnungen beziehen -sich nur auf die 
Eckpunkte eines Polygonzugs: 
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Die Darstellung der Zeichen in beliebiger Größe wird durch 
die Formel: x_neu = x * x_Size erreicht. Um die Schrift bei 
Kursivdarstellung entsprechend zu neigen, wird die x-Ordi- 
nate des Zeichens um einen bestimmten Betrag verschoben, 
der von der zugehörigen y-Ordinate abhängt: x_neu = x + 
Kursiv * y. 

Bei der Rotation des Zeichens um seinen Ursprung (linkes 
unteres Eck) wird die Berechnung komplexer, da es sich um 
eine echte Koordinatentransformation mit Hilfe einer Rotati- 
onsmatrix handelt. Multipliziert man die Rotationsmatrix mit 
den jeweiligen Vektoren, erhält man die folgenden Gleichun- 
gen: x_neu=x*cos(+)-y*sin(+);y_neu=x*sin(+)+y*cos(+). 
Zu diesen Werten werden noch die Bildschirmkoordinaten 
addiert. Nach Berechnung zweier Koordinaten wird eine 
Linie des Zeichens auf dem Bildschirm dargestellt. 





Die Assembler-Routinen liefern keine Rückgabewerte. 
Die benötigten Parameter entnehmen Sie der nachfolgen- 
den Aufstellung. Übergabe siehe Listing auf den Disket- 
ten. 


Routine: _INIT_POINTER 
Funktion: _Initialisierung 
Parameter: keine 


Routine: SET_COLOR 
Funktion: Farbe, Linienart und Grafikmodus setzten 
Parameter: Color: Zeichenfarbe 

Mask: Linienmaske (16 Bit) 

Mode: Grafikmodus (0, 1, 2 oder 3) 
Routine: SET_PARAMETER 
Funktion: Paramater für Schriftdarstellung tlegen 


Parameter: Alpha: Drehwinkel in Bogenmaß [0-2*r] 
Kursiv: Kursivkonstante (0-300) 
xsize, ysize: Zeichengröße (0-600) 


Routine: TEXT_OUT 

Funktion: Textausgabe 

Parameter: Text: Zeiger auf auszugebenden Text 
xpos, ypos: Bildschirmposition in Pixel 
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Cursor an GEM- 
Textattribute anpassen 


Mit Hilfe dieser Routine können Texte an be- 
liebiger Stelle mit Ausnutzung aller GEM-Text- 
attribute eingelesen werden. Texteingaben im 
rechten Winkel oder auf dem Kopf sind kein 
Problem. 


Tom Quellenberg 


buten, die von der Routine, soweit nötig, selbständig 

erkannt werden. Eine Korrektur mit Backspace ist 
möglich. Der Clou aber ist, daß die Größe des Cursors immer 
der Größe der gerade gewählten Schrift automatisch ange- 
paßt wird. Ist die Schrift imrechten Winkel gedreht, wird auch 
der Cursor um diesen Winkel versetzt. 

Zu Beginn können verschiedene Textattribute eingestellt 
werden. Dies sind die Schriftgröße (0 bis 27), der Ausgabe- 
winkel (0, 90, 180 oder 270) der Textstil (0 bis 31). Außerdem 
kann festgelegt werden, ob die anschließende Ausgabe im 
Replace- oder Transparent-Modus erfolgen soll. 

Nun wird der Cursor auf dem Bildschirm dargestellt und 
kann mit Hilfe der Maus an eine beliebige Stelle bewegt 
werden. 


D ie Texteingabe erfolgt mit den gerade aktuellen Attri- 





Mit der rechten Maustaste kann die Funktion abgebrochen 
werden, mit der linken Maustaste oder einer beliebigen Taste 
auf der Tastatur erfolgt der Start der Eingabe. 

Nach Beendigung der Eingabe mit der RETURN-Taste wird 
der Text mit dem am Anfang festgelegten Schreibmodus 
ausgegeben. Erfolgt die Ausgabe im Transparentmodus, 
wird der Hintergrund, auf dem der Text geschrieben wird, 
nicht gelöscht (auf schwarzem Hintergrund wären die Buch- 
staben nicht zu sehen). Im Replace-Modus wird dagegen der 
Hintergrund gelöscht (allerdings löschen sich Buchstaben, 
wenn sie kursiv und groß geschrieben werden, teilweise 
gegenseitig aus). 

Der Cursor kann nun wieder frei auf dem Bildschirm bewegt 
werden, und mit einem Druck auf die linke Maustaste wird die 
Ausgabe mit den gleichen Textattributen fortgesetzt. 

Durch einen Druck auf die rechte Maustaste läßt sich das 
Programm beenden. Die Einstellungen der Textattribute kön- 
nen damit auch verändert und dann die Textausgabe mit den 
neuen Einstellungen fortgesetzt werden. 





Aufruf: 
Funktion: 


Gem_text 

Festlegung der Textattribute und Textein- 
gabe/-ausgabe 

Parameter: keine 

















BPN Software 


Der SteuerStar '9 
Lohn- u. Einkommensteuer 91 
50 ,-— DM/Update 30 DM 
für alle ATARI-ST sw/col 
Test: ST-Magazin 4/89: 
"Der Steuerstar... nimmt ohne 
Zweifel einen sicheren Platz 
in der Reihe der Spitzensoft- 
« ware für den ST ein.” 
Dipl. Finanzwirt ]. Höfer 
Grunswald 2a 
8272 Wipperfürth 
Tel. 02192/3368 











BT SoftwareS 


& AH; S. >. Software 


Roßbach. Kr Br 06625/5658 O 
D-6434 Niederaula 3 Fax. 06625/5730 


Deluxe CNC Animate Fräsen 
Der Simulator für Ihren Atari ST,STE und TT. 
Simuliert eine 3D-bahngesteuerte Fräsmaschine nach 
DIN 66025 (alle gängigen Zyklen 
enthalten) Mit deutscher Anleitung. 
Preis nur: 149,- DM 


Deluxe CNC Animate Drehen 
Der Simulator CNC-Drehen. Er simuliert eine 
2D-bahngesteuerte Drehmaschine nach DIN 66025 
Programmierung. Mit deutscher Anleitung! 
Preis nur: 149,- DM 
Profi Rechnung 
Das neue Fakturaprogramm für Ihren Atari. Erstellen 
Sie in windeseile Rechnungen, Angebote, usw. 
Preis nur 69,- DM 
Demo jr 6,-DM; Infos kostenlos; Updateservice 
Alle Programme für Atari ST-TT, Amiga. MS-DOS 
und a 30 en Änderungen vorbehalten 





Peter Notz 
Hans-Denck-Straße 14a - W-8070 Ingolstadt - Tel./FAX: 0 84 50 / 7669 





Preissensationen! 
Ein Anruf zum Staunen und Sparen! 


Steve 3.0 Script 2x 
Signumi3 Cypress 

Tempus 2.xx Edison 

Publ, Part. Master Timeworks DTP 
Phönix 1.5 Themadat 4.x 
LDW-Powercale 2 
CAdja Connecticad 

ST Statistik (Heim) ST Statistik 
Arabeske 








ST Perspective 
Piccolo Megapaint II 4.x pro 
tms Vektor 3.1ST/TT  PureC 

ST Pascal plus 


Convector 

Lattice C 

Maxon Pascal 1.5x 
GFA Basic. 


CCD Modula 2 
Maxon Prolog 
Basic nach C 


Omikron Comp. 3.5 FForth 
1stfibuUMAN 





K-Fakt 2.x. 











Scigraph 2.x 
Mortimer Plus 
CoCom 

Quick ST II 
Kobold 

Argon Backup 
1st Lock 
Multiterm BTX 
Perfect Koys 
NEC-Drucker 


Diskus 2.xx 
MultiGEM 
Hotwire 
Codekeys 79,- 
MultiDesk deluxe 
x-Boot 
Skyplot plus 
eise! 













Lagerarikel werden sbart au 
Versandkostenpauschäle DM 8,- plus NN, Vorausk 
24 Stunden Service; fordern Sie unsere Preisliste a 





Ab zwei Artikel frei 
Lieferzeit vorbehalten 








anag2 STondernet 85 








PROGRAMMIERTIPS 


Geglättete 
Polygonzüge 


Polygonzüge haben einen Nachteil - es sind 
Polygonzüge! Die hier vorgestellte Routine 
nimmt dem Polygonzug seine Ecken, sie inter- 
poliert zwischen den einzelnen Punkten. 


ine Kurve ohne dietypischen Ecken von Polygonzügen 
= ist nicht ohne eine zusätzliche Berechnung möglich. 

Interpolation bietet sich geradezu an, um eine Kurve 
sichtbar zu glätten. Vielleicht werden derartige Routinen 
auch mal in einigen Grafikprogrammen aufgenommen! 

Aber erst eine kurze Einführung in die mathematischen 
Notwendigkeiten. Interpolation wird benötigt, wenn man 
statt einer Funktionsvorschrift nur einzelne Werte kennt, 
beispielsweise bei einer Reihe von Meßwerten. Mit Hilfe 
mathematischer Formeln werden Zwischenwerte berechnet, 
so wie sie tatsächlich sein könnten. Zumindest sollte eine 
Interpolation so gute Werte liefern, daß sie von tatsächlichen 
nur minimal abweichen. 

Bei unserem Programm werden ebenfalls Werte angenä- 
hert. Vorgegeben ist eine Reihe (mindestens vier) von Werte- 
paaren (x/y) für Bildschirmkoordinaten. Durch diese Punkte 
wird eine Kurve gelegt. Das Beispielprogramm liefert schon 
eine recht anschauliche Kurve. Die Marker zeigen, welche 
Punkte vorgegeben waren. Es sind wirklich nur zwölf! 

Gerade war schon von Funktionswerten die Rede. Diese 
sind hier die Bildschirmpositionen, also x/y-Koordinaten- 
paare. Neben diesen Werten sind noch Ableitungen nötig. 
Die erste Ableitung einer Funktion sagt etwas über ihr Wachs- 
tumsverhalten aus, die zweite etwas über ihr Krümmungs- 
verhalten - und genau das interessiert uns! Wir brauchen 
nunmehr neben den Bildschirmkoordinaten auch das Krüm- 
mungsverhalten der Kurve in den jeweiligen Punkten. 

Das ist nicht so schlimm, denn die Aufgabe der Berechnung 
übernimmt die Routine. Allerdings müssen zwei Werte vor- 
gegeben werden; das Programm kann das Krümmungsver- 
halten am Anfangs- und Endpunkt der Kurve nicht berech- 
nen. Aber zwei Werte sind ja leicht anzugeben, notfalls nimmt 
man immer 0, was bedeutet, daß die Kurve an ihren beiden 
Endpunkten nicht gekrümmt ist. 

Bevor die Kurve ausgegeben werden kann, ist eine Nähe- 
rung zu berechnen. Diese Aufgabe übernimmt die Routine 
Make_Splines. Die Ausgabe übernimmt dann Draw_Splines. 
Mehr ist bei der Bedienung nicht zu beachten. 

Draw_Splines hat die Aufgabe, die Kurve auszugeben. Die 
bereits berechneten Werte werden in die Spline-Interpolie- 
rende (die Routinen benutzen Spline-Interpolation), ein kubi- 
sches Polynom, eingesetzt und ausgewertet. Die Auswer- 
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tung ist lediglich die Ausgabe der Punkte, d.h Linien zwi- 
schen den einzelnen Punkten. Wieviel interpolierende Punk- 
teberechnet werdensollen, istauch der Routine Draw_Splines 
anzugeben. Da mit Linien gearbeitet wird, brauchen es nicht 
sehr viele zu sein. Je mehr Punkte berechnet werden sollen, 
desto länger dauert die Ausgabe auf dem Monitor. 

Die Hauptaufgabe fällt der Make-Splines-Routine zu. Zu- 
erst werden Parameter berechnet. Hat man beispielsweise 
eine Funktion f(x) gegeben, so existieren neben den Bildwer- 
ten f(x) auch Urbildwerte x (Eingangsparameter für die Funk- 
tion). Die Bildschirmkoordinaten werden nur als Bildwerte 
angesehen, was fehlt, sind Urbildwerte. 

Make_Parameter liefert die Urbildwerte, einfach den Ab- 
stand der Punkte nacheinander. Danach wird in der Routine 
Make_System das Gleichungssystem aufgebaut, welches 
als Lösung das Krümmungsverhalten der Kurve an den 
einzelnen Punkten liefert, oder, um es etwas genauer auszu- 
drücken, es wird die zweite Ableitung an den einzelnen 
Stellen berechnet. Glücklicherweise hat die Koeffizienten- 
matrix dieses linearen Gleichungssystems Tridiagonalge- 
stalt, wodurch sich der Rechenaufwand verringert. 

Bevor man die Koeffizienten des Interpolationspolynoms in 
Set_Splines errechnen kann, muß noch mit Solve_System 
die Lösung des Gleichungssystems ermittelt werden. 

Zur Anwendung der beiden Routinen Make_Splines und 
Draw_Splines muß ein Array mit mindestens 4 Bildschirm- 
punkten (x/y) definiert werden. Außerdem müssen zwei Ar- 
rays für die errechneten x- und y-Splines zur Verfügung 
stehen. Als Eingangsparameter benötigt Make_Splines die 
Adresse des x/y-Arrays, die Anzahl der (vorhandenen) Bild- 
schirmkoordinaten, die Adressen der beiden Splines-Arrays 
und die beiden Krümmungswerte. Zum Zeichnen der Kurve 
rufen Sie Draw_Splines mit den beiden Splines-Arrays und 
der Anzahl der Werte auf. 

Wer mehr zur Theorie der Spline-Interpolation oder zu den 
Grafikfunktionen des VDI wissen möchte, findet in den bei- 
den unten aufgeführten Büchern sicherlich wertvolle Hinwei- 
se. 


Literatur: 

[1] Numerische Mathematik, H.R. Schwarz, Teubner 

[2] Atari St Profibuch, H.-D. Jankowski/J. F. Reschke/D. 
Rabich, Sybex 





Aufruf: Make_Splines(points, nr, spx, spy, kra, kre) 
Funktion: berechnet Splines zu den x/y-Koordinaten- 
paaren 
Parameter: points: Array mit x/y-Werten 
nr: Anzahl der Werte im point-Array 
spx, spy: Arrays für Splines-Werte 
kra, kre: Krümmung (2. Ableitung) der 
Kurve im Anfangs- und Endpunkt 
Aufruf: Draw_Splines(spx, spy, n) 
Funktion: zeichnet die Kurve 
Parameter: spx, spy: Arrays mit Splines-Werten 
n: Anzahl der Werte 
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Schönere 
Kreise 


Einen echten Kreis auf einem quadratischen 
Raster, wie es bei Bildschirm- und Drucker- 
ausgabe vorhanden ist, zu zeichnen, ist un- 
möglich. Es besteht nur die Möglichkeit, die 
einzelnen Punkte des Kreisumfangs im Raster 
so zu setzen, daß die Abweichung von der 
idealen Linie möglichst gering ist. 


Andreas Hollmann 


ur Lösung dieses Problems werden verschiedenen 
Z Algorithmen verwendet. Der Algorithmus, der vom VDI 

zum Kreiszeichnen verwendet wird, besitzt zwei Merk 
male, die sofort ins Auge stechen: die Kreise werden unheim- 
lich schnell und unheimlich häßlich gezeichnet. 

Leider habe ich keine Informationen über den benutzten 
Algorithmus, aber, betrachtet man den Kreisbogen bei be- 
stimmten Radien, so drängt sich die Vermutung auf, daß in 
Wirklichkeit Polygone gezeichnet werden. Das würde die 
hohe Geschwindigkeit erklären, denn ein paar Polygonecken 
sind schneller berechnet als jeder einzelne Punkt auf dem 
Kreisumfang. 

Die durchgezogenen Linien der VDI-Darstellung sind schon 
schlimm genug, aber bei Verwendung verschiedener Linien- 
muster packt einen das Grauen. 

Schönere Kreise erhält man durch das Setzen einzelnen 
Pixel (und keiner Linienzüge). Das Zeitaufwendigste dabei ist 


IDEE 


die Berechnung jedes einzelnen Kreispunktes. Der in der 
Routine verwendete Algorithmus basiert auf Horns Algorith- 
mus, der zur Berechnung nur Addition, Subtraktion und 
binäre Schiebeoperationen verwendet (keine Multiplikation). 

Der Routine circle werden die x- und y-Koordinaten des 
Kreismittelpunktes, der Radius und das Linienmuster (in 
einem 16-Bit-Word) übergeben. Beim Setzen der einzelnen 
Punkte wurde darauf geachtet, daß das VDI-.Clipping-Recht- 
eck berücksichtigt wird und auf Bildschirmen mit anderer 
Auflösung keine Probleme auftreten. 

Der Kreis wird in acht Oktanten unterteilt, deren Kreisbögen 
nacheinander gezeichnet werden. Vor dem Setzen eines 
Punktes wird geprüft, ob das Bit 0 im Linienmuster-Wort 
gesetzt ist. Danach wird das Linienmuster um ein Bit rotiert, 
man spart dadurch (zeit)aufwendige Bit-Zählerei. 

Das Ergebnis läßt sich in der abgebildeten Hardcopy begut- 
achten. Bei den Kreisen mit durchgezogenen Linien fällt auf, 
daß selbst Kreise von 2 Pixeln (kleinster Kreis) noch kreisähn- 
liche Objekte ergeben, wogegen man beim VDI-’Kreis’ einen 
Stern sieht. 

Beim gepunkteten VDI-’Kreis’ kleben teilweise einige Pixel 
in Gruppen zusammen, als Ausgleich dafür läßt VDI aber an 
anderen Stellen etwas größere Lücken ... Horns Algorithmus 
zeigt solche Effekte nicht und setzt die Punkte in gleichmä- 
Bigen Abständen 


Literatur: 

Computer Graphics and Image Processing 
1979 Marek Doros 

Incremental Circle Generator 





: Aufruf: circle(x, y, r, type) 
Funktion: zeichnet Kreise nach Horns Algorithmus 
Parameter: x, y: Mittelpunktskoordinaten des Kreises 
[ r: Kreisradius 
type: Linientyp (16-Bit-Wort) 
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Überblendeffekte 


Ein gutes Programm sollte auch grafisch an- 
sprechend gestaltet sein. Wenn das Titelbild, 
von der Diskette geladen, ruckweise auf den 
Bildschirm stottert, macht das sicherlich kei- 
nen positiven Eindruck auf den Anwender; eine 
Möglichkeit zum eleganten Einblenden von 
Bildern muß her! 


Andreas Hollmann 


keit, Grafiken, unter Verwendung von Zufallszahlen, 

‘weich’ überzublenden. Wie sich bei der Entwicklung 
der Routinen herausgestellt hat, dürfen die Zufallszahlen 
jedoch nicht völlig zufällig sein. Stellen Siesich folgenden Fall 
vor: Sie wollen zwischen Bildern mit je 32 KB byteweise 
überblenden. Sienehmen dazu Zufallszahlen zwischen 1 und 
32000 und blenden in einer Schleife mit 32000 Durchläufen 
um. Wo das Problem liegt, fragen Sie. Nun, wer sagt Ihnen 
denn, daß alle 32000 Zahlen genau einmal vorkommen? 
Zufallszahlen haben leider die Angewohnheit, daß man eben 
nicht weiß, wann (und wie häufig) sie auftreten. Für die 
folgenden Routinen benötigen wir also ‘Zufallszahlen’, bei 
denen sichergestellt ist, daß aus dem gewählten Bereich, 
jede Zahl exakt einmal vorkommt. Mit Hilfe einer Liste, in die 
alle bereits vorgekommenen Zahlen eingetragen werden, 
könnte man das Problem zwar lösen, jedoch nicht in einer 
annehmbaren Zeitspanne. (Bei bitweiser Überblendung be- 
nötigen Sie Zahlen von 1 bis 256000!) 


D ie hier vorgestellten Routinen bieten Ihnen die Möglich- 


Regelmäßiger Zufall 


Die erste Lösungsmethode hat eigentlich recht wenig (um 
genau zu sein gar nichts!) mit Zufall zu tun: Bei jeder Über- 
blendung wird als Startwert die Bildadresse O0 genom[Sie 
können die Routinen auch dahingehend erweitern, daß Sie 
eine beliebigen (zufälligen) Startwert nehmen]. Hierzu wird 
nun ein Wert zwischen 1 und 31999 addiert (Einschränkun- 
gen siehe unten). Bei einer Zieladresse größer als 32000 wird 
32000 subtrahiert. Wenn wir nun eine Schleife mit 32000 
Durchgängen programmieren, so wird jeder Bildpunkt (hier 
byteweise) genau einmal bearbeitet. Bei der Wahl des Addi- 
tionswertes können Sie weitgehend frei entscheiden; aller- 
dings darf die Konstante keine gerade Zahl sein und nicht mit 
5 enden. Trotz dieser Beschränkungen ergeben sich 12800 
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Die Assembler-Routinen liefern keine Rückgabewerte. 

Die benötigten Eingangsparameter können derfolgenden 

Aufstellung entnommen werden: 

Routine: Addifade(Bild, Schirm, Add) 

Funktion: pixelweises Überblenden durch 
Additionsalgorithmus 

Parameter: Bild: Speicherstartadresse der Bilddaten 
Schirm: Adresse des physikalischen 
Bildschirms 
Add: Additionsparameter (zwischen 1 und 
32000) 

Routine: Add8fade(Bild, Schirm, Add) 

Funktion: byteweises Überblenden durch Additions- 
algorithmus 

Parameter: Bild: Speicherstartadresse der Bilddaten 
Schirm: Adresse des 
physikalischen Bildschirms 
Add: Additionsparameter 
(zwischen 1 und 256000) 

Routine: Rnd1fade(Bild, Schirm) 

Funktion: pixelweises Überblenden durch Pseudo- 
zufallszahlen 

Parameter: Bild: Speicherstartadresse der Bilddaten 
Schirm: Adresse des physikalischen 
Bildschirms 

Routine: Rnd8fade(Bild, Schirm) 

Funktion: byteweises Überblenden durch Pseudozu- 
fallszahlen 

Parameter: Bild: Speicherstartadresse der Bilddaten 
Schirm: Adresse des physikalischen 
Bildschirms 











mögliche Effekte (siehe Routine Add8fade). Bei einer 
pixel(bit)weisen Überblendung stehen Ihnen sogar 102400 
Möglichkeiten zur Auswahl (siehe Add1fade). 


Pseudozufall 


Möchte man den Effekt doch lieber etwas zufälliger haben, 
kann man auf Pseudozufallszahlen zurückgreifen. Der Unter- 
schied zwischen echten und Pseudozufallszahlen besteht 
darin, daß sich die Zahlenfolge beim ‘unechten’ Zufall nach 
einer bestimmten Periode wiederholt. Realisiert werden die- 
se Zahlen mit rückgekoppelten Schieberegistern. Bei byte- 

















Integriertes System 


MAXON Pascal bietet alles in einem. Compiler, Editor, Linker und Assembler 
stehen resident zur Verfügung. 


>» _MAXON Pascal arbeitet vollständig im RAM. Kein Zugriff auf Platte/Diskette 

notwendig. Dadurch erreicht man traumhaft schnelle Turnaround-Zeiten. 

Interaktive Fehlererkennung bei Syntax- und Runtime-Fehlern. Der Compiler 

springt sofort zur fehlerhaften Stelle im Editor. 

» zusätzlich ist ein Compiler als CommandLine-Version zum Einbinden in 
eigene Entwicklungsumgebung enthalten. 


Y 


Geschwindigkeit 

Turboschneller Single-Pass-Compiler (20.000 Zeilen auf ST) 

Schneller und kompakter Programm-Code 

UNITS erlauben die modulare Zerle- 

gungbestimmter Programmteile und 

schnellste Übersetzungauch beigro- 

Ben Projekten. 

>» Code-Optimierung - der integrierte 
Linker bindet nur die benötigten Tei- 
le einer UNIT an das Programm. 


vv 


Systemunterstützung 
MAXON Pascal erlaubt den Zugriff auf sämtliche Funktionen des ST-Be- 
triebsystems (VDI, AES, BIOS, XBIOS, GEMDOS), in standardisierter, C- 
kompatibler Form. 


Kompatibilität 
MAXON Pascal istein eigenständiges, aber auch weltoffenes Pascal-System 
für Atari. 
> weitgehende Kompatibilität zu TurboPascal 5.0. Programme können ohne 
große Änderungen übernommen werden. 
GRAPH-UNIT unterstützt Standard PC-Grafik 


eine spezielle ST Pascal-UNIT stellt abweichende Befehle und Definitionen 
zur Verfügung. ST Pascal-Programme lassen sich dadurch leicht portieren. 


vv 


INLINE-Assembler 

MAXON Pascal versteht auch direkten Assembler-Code. Somit lassen sich 
systemnahe oder extrem zeitkritische Programmteile in Assembler verfassen 
und samt Variablenübergabe direkt in den Pascal-Source einfügen. 


Hochpräzise Arithmetik 

MAXON Pascal verfügt über schnelle mathematische Funktionen mit höch- 
ster Genauigkeit (18 Stellen, +1.1e*‘* Stellen), sowie über die Unterstützung 
des 68881-Floating Point Prozessors. 


OnLine-Help 


Auf Tastendruck liefert die integrierte Hilfefunktion Erklärungen zu dem 
angewählten Befehl. 


Zahlreiche Beispiele erläutern z.B. die Programmierung von GEM-Program- 
men in Pascal. 


Für CLI-Betrieb steht externes Help-Accessory zur Verfügung. 


Neu in V. 1.5 


typisierte Konstanten: erlaubt die Typ-Zuweisung bei Konstanten bei gleich- 
zeitiger Definition des Inhalts. 


ARRAYS > 32kByte: Array können nun beliebig groß werden. 
ABSOLUTE: Definition von Variablen an absoluter Speicheradresse. 
Optimierung der internen Speicherverwaltung (Word, Byte). 
Überarbeiteter Editor 

Update DM 30.- gegen Einsendung der Originaldiskette 

{nur Vorauskasse möglich) 


V 
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Turbopower für Atari ST/TT 


MAXON Computer GmbH 
Schwalbacher Str. 52 « 6236 Eschborn 
Tel.: 06196 /481811 « Fax: 06196/41885 


DIE WELT HAT EINE 


Erwähnte Computer- und Software-Bezeichnungen sind Han- 
delsmarken und/oder Warenzeichen der betreffenden Hersteller 
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irocedure EventLoop; 

ya event} Integer; 
n 

















Help: EUMT_MULTT LT 
‚one of the vital functions in a "nornal of 
the user to generate a nultitude of events, mhich tha_ | 
then can dispatch easily. 


Function evnt-nulti 

(ev_nflags, ev_nbelicks, 

ev_nbnask, ev.nbstate, 
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Build all 
Find Error 
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Help: SETTEXTJUSTIFY 
Procedure Setfextäustifg@horiz, Vert : Nord); 


ni also: Setlextstule, GetlextSettings, QutText, QutiextXY, Graph 
’onst 
LeftText = 8; CenterText = 1; Rightiext = 2; 
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weiser Überblendung benötigt man ein 15 Bit breites Regi- 
ster. Dieses deckt den benötigten Wertebereich von 32000 
ab (2'°=32768). Das Register erhält am Anfang den Startwert 
‘1’. Nun werden die beiden untersten Bits (1 und 0) miteinan- 
der exklusiv-oder-verknüpft. Das Ergebnis (eine 0 oder 1) 
wird, nach Rechtsverschiebung des Registers, in die höch- 
ste Stelle (Bit 14) geschrieben (siehe Bild). Dies ist die neue 
Pseudozufallszahl. Die maximal erreichbare Periodenlänge 
ist 2n-1, hier also 32767, d.h. nach 32767 Durchläufen ist 
jede Zahl genau 1mal vorgekommen. Alle Zahlen ab 32000 
werden ignoriert. Zum Überblenden werden also alle Zahlen 
zwischen 0 und 31999 verwendet (siehe Rndäfade). 

Auch bei dieser Methode ist eine pixelweise Überblendung 
möglich. Allerdings wird dann ein 18 Bit breites Register 
benötigt. Auch die Abgriffe finden an anderen Stellen (Bit 0 
und 7) statt. Selbst bei Assembler-Programmierung kommt 
man bei dieser Routine (Rnd1fade) an die Grenze der Rech- 
nerleistung eines 8MHz-68000ers (für eine Überblendung 
werden 5,7s benötigt). 


Verwendung der Routinen 


Aus Geschwindigkeitsgründen sind alle vier Routinen in 
Assembler programmiert. Sie benötigen als Eingabepara- 


Fastzoom 


Eine Zoom-Funktion sollte in keinem Gra- 
fikprogramm fehlen. Aber auch andere An- 
wendungenkönnenvoneinerschnellen Zoom- 
Routine profitieren. Wie wäre es z.B. bei ei- 
nem Titelbild mit Schrift- oder Bildvergröße- 
rung (geringerer Speicherplatzbedarf auf Dis- 
kette)? 


größerungsfaktor, den (Bildschirm-)Ort des Originals, 

dessen Größe, den Zielort der Vergrößerung [jeweils 
für die horizontale (x) und Vertikale (y)] und den Schreibmo- 
dus. 

Die Routine vergrößert das Original zeilenorientiert von 
hinten nach vorne. Die Richtung wurde gewählt, damit ein 
Objekt links oben am Bildschirm auch dorthin vergrößert 
werden kann. Beim umgekehrten Durchlaufen der Schleifen 
würde dies nicht funktionieren. Beim Vergrößern würde so 
ein mit derersten Zeile gefüllter Bildausschnitt entstehen; bei 


D ie Routine benötigt als Eingangsparameter den Ver- 
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meter jeweils die Adresse des aktuellen (physikalischen) 
Bildschirmspeichers (XBIOS-Funktion 2) und die der Stelle, 
an der das Bild im Speicher beginnt. Die Additionsroutinen 
(Add1fade und Add8fade) bekommen als dritten Parameter 
den Additionswert. 

Das Beispielsprogramm demonstriert Ihnen anschaulich 
die Überblendeffekte. Es benötigt dazu eine ASCII-Datei 
namens ‘PIC_SHOW.INF’ welche folgenden Aufbau haben 
muß: In der ersten Zeile steht die Sekundenanzahl, während 
der ein Bild jeweils zu sehen sein soll (Sie können die Routine 
dahingehend abändern, daß sie jedem Bild eine eigene 
Verweilzeit zuweisen). Zeile zwei enthält die Anzahl der 
Wiederholungen für die komplette Bildsequenz. In den dar- 
auffolgenden Zeilen werden die Pfade und Namen der zu 
zeigenden Bilder und der gewünschte Überblendeffekt (im 
Beispiel sind 10 ausgewählt) angegeben. Die letzte Zeile 
muß den Befehl ‘end’ enthalten. Ein Beispiel: 


10 

3 
a:\bilder\bildi1.pic 
effekt 3 
a:\bilder\bild2.pic 
effekt 7 

end 


Text sogar ein leerer Bildschirm: Die erste Zeile wird abgeta- 
stet. Diese ist bei Text leer. Bei einem Vergrößerungsfaktor 
von z.B. 5 würden nun 5 Leerzeilen am oberen Bildschirm- 
rand erzeugt. Die nächste Zeile (normalerweise der oberste 
Rand der Buchstaben) wäre nun eine Leerzeile und würde 5 
weitere Leerzeilen erzeugen. Das Ergebnis wäre eine leerer 
Bildschirm(ausschnitt). 





Aufruf: Zoom(Vx, Vy, Xpos, Ypos, X, Y, Xzoom, 
Yzoom, Modus) 
Funktion: variable Vergrößerung eines Bildschir- 


mauschnitts 

Parameter: \x, Vy: x- und y-Vergrößerungsfaktor 
Xpos, Ypos: Position des Originals (linkes 
oberes Eck) 
Xw, Yw: Größe des zu zoomenden 
Objekts (in Pixeln) 
Xzoom, Yzoom: Position des gezoomten 
Bildes (linkes oberes Eck) 
Modus: Schreibmodus 
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Kopieren und Verschieben 
variabler Bildausschnitte 


Jedes anspruchsvolle Mal- und Grafikpro- 
gramm verfügt über eine Funktion, die es 
gestattet, Bildausschnitte von beliebiger Grö- 
ße auf dem Bildschirm zu verschieben bzw. zu 
kopieren. Hierbei besteht der Unterschied zwi- 
schen ‘Verschieben’ und ‘Kopieren’ darin, daß 
bei der Funktion ‘Verschieben’ der Ausschnitt 
im wahrsten Sinne aus dem Bild ‘'herausge- 
schnitten’ wird. 


Hans-H. Ackermann 


schnitt im Bild, die Kopie des Ausschnitts läßt sich an 
anderer Stelle beliebig positionieren. Das Verschieben 
von grafischen Einheiten stellt den wesentlichen Bestandteil 
des sogenannten Layouts etwa einer Druckvorlage dar. Die 


RB ei der Funktion ‘Kopieren’ verbleibt der Originalaus- 


Die Realisierung 


Die Realisierung dieses an sich einfachen Prinzips findet sich 
in der Routine Verschieben(Copy). Der einzige Eingangspa- 
rameter bestimmt, ob der Ausschnitt verschoben (Copy = 0) 
oder kopiert (Copy = 1) werden soll. 

Die Hauptschleife ist nur notwendig, falls nach dem Aufruf 
der Routine die Möglichkeit bestehen soll, mehrere Verschie- 
bungen unmittelbar nacheinander vornehmen zu können. 

Ein Druck auf die linke Maustaste bestimmt nun den linken 
oberen Eckpunkt des zu verschiebenden/kopierenden Recht- 
ecks. Danach wird ein Rahmen gezeichnet, dessen rechtes 
unteres Eck sich an der jeweils aktuellen Mauszeigerposition 
befindet. Nach Loslassen der linken Maustaste wird die 
innerhalb des Rahmens liegende Grafik zwischengespei- 
chert. Soll der Ausschnitt nur verschoben werden, so wird 
nun der Bereich innerhalb des Auswahlrahmens gelöscht. 
Außerdem wird die Position des Mauszeigers an die linke 
obere Ecke gesetzt. Nun kann durch Bewegung der Maus 
der Ausschnitt auf dem Bildschirm an die neue Position 
verschoben werden. Er wird dort durch ein erneutes Anwäh- 
len der linken Maustaste 'festgeklebt'. 

Anhand des Beispielprogramms kann die Funktionsweise 
der Routine demonstriert werden. 


hier vorgestellten Routinen lassen Schere und Klebstoff - 
Hauptwerkzeuge beim Layout - endgültig überflüssig wer- 
den: Alle grafischen Einheiten, seien es Texte, Bilder oder 





auch Notensysteme, können mit der Maus auf dem Bild- | Aufruf: Verschieben(Copy) 

schirm druckfertig arrangiert werden. Funktion: Mittels Maus kann ein rechteckiger 
Bildschirmbereich ausgewählt werden, der 

Das Prinzip anschließend an eine neue Position 
verschoben (Copy = 0) oder kopiert (Copy 

Der zu verschiebende Bildausschnitt wird mit dem ‘'Gum- = 1) werden kann. 

mifaden’ eingerahmt. Dieser eingerahmte Bildschirmbereich Parameter: Copy: Bestimmt Funktion der Routine. 0: 


wird in geeigneter Weise zwischengespeichert - gepuffert - 
und kann dann an beliebiger Stelle mit der Maus wieder auf 
dem Bildschirm plaziert werden. Bei der Funktion „Verschie- 
ben“ wird der Bereich unter dem Rahmen gelöscht. 


Verschieben; 1: Kopieren 











Der neue 
»Key-Klick« ist da 


für die ST-Baureihe, definierter Druckpunkt, kein schwammiges Schreibgefühl mehr ! 
Auch ohne RTS-Tastenkappen einsetzbar — bitte Muster kostenlo: 


RTS-Tastenkappen DM 95,— 
für ST u. Mega-St, 

komplett in Farbe 'weiß/grau, 

auch in schwarz und beige lieferbar. 






RTS-Sondertasten DM 15, — 
für PC/AT-Speed. 
RTS-Farbtasten DM 20,— 


nach Liste in rot, orange, grün, gelb. 


RTS-Key-Klick DM 69,- 


komplett-Set für alle Tasten. 


Rls - Elektronik Postfach 64 - 7533 Tiefenbronn - @ (07234) 6915 +5232 - Fax 5574 
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Lasso-Funktion 


Ich stand vor dem Problem, aus einem Bild 
einen unregelmäßig geformten Ausschnitt her- 
auszutrennen. Viele Malprogramme bieten zu 
diesem Zweck eine ‘Lasso’-Funktion an. Da 
ich weder ein solches Programm noch eine 
Grafik-Bibliothek mit dieser Funktion mein ei- 
gen nenne, entschied ich mich, die entspre- 
chende Routine selbst zu erstellen. 


eine Lasso-Routine schneidet einen mit der Maus 
M definierten Grafikblock aus und legt ihn zwecks 

Weiterverarbeitung in einem Puffer im BITBLT-For 
mat ab. Im Demoprogramm kann der gewonnene Ausschnitt 
an anderer Stelle im Bildschirm einkopiert werden. 


Verwendung der Routine 

Die Lasso-Prozedur wird vom Hauptprogramm aus mit 
Lasso(Undo,Modus) aktiviert. Der Eingabeparameter Undo 
entscheidet, ob ein zusätzlicher Speicher für eine UNDO- 
Funktion angelegt werden soll (Undo = 1) oder nicht (Undo = 
0). Der Parameter Modus gibt die Art der Verknüpfung des 
Lasso-Inhaltes mit dem Hintergrund an. 

Nach Aufruf wird zunächst mit einem Mausklick der Lasso- 
Startpunkt festgelegt. Der Zeiger zieht ab jetzt die Schlinge 
um die Grafik, bis zum zweiten Mal geklickt wird. Ergibt sich 
keine geschlossene Form, werden der Anfangs- und End- 
punkt der Strecke miteinander verbunden. Der so ausge- 
wählte Bildschirmausschnitt kann nun verschoben werden. 
Die linke Maustaste setzt den Block gemäß der mit Modus 
festgelegten Verknüpfungsart auf das Bild, die rechte been- 
det die Bearbeitung. 


VHF-Computer GbR 
Daimlerstr. 13 


7036 Schönaich 


Telefon: 


Prinzip der Lasso-Routine 
Um einen unregelmäßig geformten Block ausschneiden zu 
können, muß man über eine Maske auf einem 2. Bildschirm 
verfügen, deren Form der des Blockes entspricht. Diese 
Maske wird einfach mit dem Originalbild UND-verknüpft, und 
der Ausschnitt steht bereit. Ist die Form ein Vieleck, reichtes, 
sie auszufüllen. Dieses Verfahren kann hier jedoch nicht 
angewendet werden, da der Benutzer mit dem Lasso jede 
beliebige Umrandung, also auch Überschneidungen, be- 
stimmen können soll. Wird z.B. eine ‘8’ als Randform ge- 
zeichnet, scheidet 0.g. Methode aus, weil lediglich einer der 
Kreise der ‘8’ mit einem Füllbefehl ausgefüllt werden kann. 
Außerdem würde bei dieser Methode die Umrandung selbst 
zum Ausschnitt gehören, was nicht wünschenswert ist. Aus 
diesem Grunde geht die Routine den umgekehrten Weg: man 
füllt den Teil des Bildes auf, der nicht vom Lasso umrahmt 
wird, und bekommt somit eine Maske zu jedweder Lasso- 
Form. Diese Maske muß, da sie invertiert ist, mit dem Bild 
NICHT UND-verknüpft werden. Ein Nachteil hierbei: um eine 
sichere Umrandung der Form durch den Füllbefehl zu ge- 
währleisten, muß an den Bildrändern jeweils 1 Punkt freiblei- 
ben, damit die Füllroutine des gesamte Lasso umschließen 
kann. 

Im Beispielprogramm wird die Routine einmal mit und 
einmal ohne UNDO-Funktion aufgerufen, wobei vorher ein 
Beispielbild mit gefüllten Kreisen gezeichnet wird. 





Aufruf: Lasso(Undo,Modus) 

Funktion: Mit der Maus kann ein unregelmäßiger Bild- 
schirmbereich ausgeschnitten und an belie- 
biger Stelle eingefügt werden 

Parameter: Undo: Wenn Undo = 1, wird ein zusätzlicher 


Zwischenspeicher für eine UNDO-Funktion 
angelegt 

Modus: Verknüpfungsart des Lasso-Bereichs 
mit dem Bildschirmhintergrund 














07031/650660 
Telefax: 

07031/654031 
Mailbox: 

07031/654106 


Wr 


Computer 


Leiterplatten-CAD-System für Atari ST/TT 





GFA-BASIC 


hat einen starken Partner gefunden: 


Die einzigartige Entwicklungsumgebung 
für GFA-BASIC ab Version 3.0 


Shell 


bequemer Aufruf von Interpreter. Compiler 
etc. über Menüleiste, Irei konfigurierbar. 
Hillstexte zu Menüs und Dialogen, Compile- 
roptionen über Dialogbox mit Erklärungen, 
Holkeys 


Analyzer 


Variablenanalyse schnell und übersichtlich 
alle Informationen über Accessory im Inter 
preter(!) verfügbar, ausg Formatier- 
rouline für kompakte Druckausgabe, da- 
durch keine ellenlangen Listen, Ausgabe in 
dividuell einstellbar, graphisches Baumdia 
\odus findet Fehler und 
gsvorschläge. 


Präprozessor 


Ausblenden/Einblenden vor 

len, dadurch Verwaltung 

Versionen innerhalb eines einzig 

tes möglich, symbolischen Konstant 
setzen, Kil-Rem. Sourcecode verschlüs- 
seln. Variablennamen ändern, Übertragung in 
PC-GFA-Basic. 


Schreibtisch 


ergo! 
ergo! 
ergo! 
ergod 
ergol 
ergo! 
ergo! 
ergo! 


Entwickelt von: 


BASIC-Online- 
Handbuch 


Im Interpreter abrufbar. alle GFA-BASIC- 
Befehle mit Syntax und Erläuterungen, ge 
ordnet alphabetisch oder nach Sachgebie- 
ten. ASCII-Codes. Fehlercod, 

Tabelle. Füllmuster. Lini 

minimaler Speicherbedart 


Dokumentations- 
Prozessor 


‚Automatische Erstellung einer Programmdo- 
kumentation, Seitennumerierung und In 
haltsverzeichnis, aufwendig formatierter 
Programmtext mit frei wählbaren Schriltat- 
tributen für Befehle, Variablen. Kommenta 
2. Zeilennummern. zu jeder Prozedur voll 
ge Kreuzverweisliste mit Seitenanga 





verkürzt Ihre Entwicklungszeiten 


begleitet Sie von der Programmidee bis 
zur abschließenden Dokumentation 


findet alte Fehler und verhindert neue! 


verbannt Handbücher und Tabellen vom 


ist das unentbehrliche Hilfsmittel für 
Einsteiger, Aufsteiger und Profis! 


sorgt für Durchblick! 
vermittelt ein neues Programmiergefühl! 


ist ergonomisches Programmieren! 
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unverbindlich ernpfohlener Verkaufspreis 


Vertrieb: 


Heim Verlag 


Heidelberger Landstraße 194 
6100 Darmstadt-Eberstadt 
Tel: (O 61 51) 5 60 57 

Fax: (© 61 51) 5 60 59 


Reinhard Temmel GesmbH K@KG St Julienstraße do A-5020 Salzburg 
CH-Sä15 Rieden-Baden 


Columbus Soft 


In Österreich bei 


In der Schweiz bei. DIZ Data Trade AG Landstroße I 


GFA-BASIC ist eingetragenes Warenzeichen der Firma GFA- Systemtechnik. 


32 


TAUSEND 
FARBEN 


Die unglaubliche Grafikkarte rüstet auf 


Mehr Leistung für weniger Geld 


Mit 256 aus 16,7 Millionen Farben bis zu 1280 x 800 Pixeln 
und mit 16 Farben bis zu 1664 x 1200 Bildpunkten wurde das 
professionelle Arbeiten für viele zufriedene Kunden zum Er- 
lebnis. Der Video-Mode-Generator zum Erstellen beliebiger, 
auch virtueller Auflösungen setzte Maßstäbe in der Monitor- 
anpassung. Die schnellen VDI-Treiber verblüfften Fachleute, 
die Presse und die Konkurrenz. 

Jetzt bringt das 32K-Erweiterungsmodul 32.768 Farben gleich- 
zeitig auf den Bildschirm und ermöglicht damit zusätzliche 
Farbtreue in der elektronischen Bildverarbeitung. 


bAAZY 


DOTS 


TK: Stadtparkweg 2 «e WD-2300 Kiel 1 
2 (0431) 33 78 81 + FAX (0431) 359 84 


Schweiz: EDV-Dienstleistungen Z (01) 784 89 47 
Niederlande: Data Skip Z (018) 202 05 81 


Crazy Dots 256 Farben für 
Mega ST oder Mega STE/TT 


1298, 


Crazy Dots 32K für 
Mega ST oder Mega STE/TT 
Inklusive 32.728 Farb-Modul 


1498,- 
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PROGRAMMIERTIPS 


Schnelle 


UNFILL-Routine 


In den meisten Fällen wird eine Routine, die 
schnell arbeiten soll, in Assembler program- 
miert. Auch bei der hier vorgestellten istesso. 
Daß aber auch in Hochsprachen Geschwindig- 
keitssteigerung durch Verwendung von trick- 
reichen Algorithmen erreicht werden können, 
zeigt die Entwicklungsgeschichte dieser Rou- 
tine. Am Anfang stand ein BASIC-Programm, 
das zum Löschen eines rechteckigen Bild- 
schirmbereiches 18 Minuten (1080 Sekunden) 
benötigt. 


NIEREN EEG 


urch Anwendung des unten aufgeführten Algorithmus’ 
D ließ sich die Geschwindigkeit auf 11 Sekunken (100mal 

schneller!) verkürzen. Noch schneller (Faktor 10) funk- 
tioniert nun die Assembler-Routine. 


Der UNFILL-Algorithmus 


DerBildschirmbereich, indem alle gefüllten Flächen beseitigt 
werden sollen, wird Zeile für Zeile abgetastet, wobei in jeder 
Zeile jeder Punkt und sein Nachfolger daraufhin überprüft 
werden, ob sie die gleiche Farbe hatten oder nicht. Wenn 
nicht, befindet sich an dieser Stelle eine Kante, und der Punkt 
wird schwarz gefärbt; ansonsten sind die beiden Punkte 
innerhalb einer Fläche und werden weiß gefärbt. Diese Ope- 
ration entspricht einer XOR-Verknüpfung der beiden Bild- 
punkte. 

Wenn man sich nun nach einem Durchlauf das Ergebnis 
anschaut, stellt man fest, daß eine kleine Unschönheit auf- 
tritt: waagrechte Linien werden auf zwei Punkte reduziert, 
was dazu führt, daß geschlossene Formen oben und unten 
offen erscheinen (siehe Bild 1. Teil C). Abhilfe schafft hier nur 
ein nochmaliges Abtasten des ursprünglichen Bildes, aber 
diesmal senkrecht. Die beiden so entstandenen Bitmaps 
werden nun übereinandergelegt, also oder-verknüpft. 
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Funktionsweise der Routine 


Nach den üblichen Initialisierungen (Stack einrichten; nicht 
benötigten Speicher freigeben), wird das Bild in den Puffer 
geladen (liegt im BSS-Segment). Anschließend wird die 
Bildschirmadresse ermittelt und das Originalbild dorthin ko- 
piert. 

In der ersten Schleife („exor1“) wird die vertikale Abtastung 
direkt auf dem Bildschirm durchgeführt. Dabei werden im- 
mer 32 nebeneinander liegende Punkte auf einmal mit ihren 
Nachfolgern in y-Richtung EXOR-verknüpft. 

Die zweite Schleife („exor2“) führt die horizontale Abtastung 
an der Kopie des Originalbilds im Puffer durch. Dabei wird ein 
Langwort, also 32 aufeinanderfolgende Pixel, umeinBitnach 
links geschoben; so hat man für zumindest 31 Pixel auf einen 
Schlag die Nachfolger in x-Richtung ermittelt. Was aber ist 
mit dem untersten Bit? Hier muß doch offensichtlich das 
oberste (nach üblicher Zählung das 31.) Bit des im Speicher 
nachfolgenden Langwortes eingefügt werden. Damit steht 
auch schonfest, daß die Abtastung mit dem letzten Langwort 
des Bildschirmspeichers beginnen muß. Und damit dasbeim 
Schieben herausfallende oberste Bit nicht verlorengeht, be- 
nutzt man den ROXL-Befehl des 68000. Durch mehrmaliges 
Hintereinanderausführen dieses Befehls wird jeweils das 
oberste Bit eines Langworts im x-Flag zwischengespeichert 
und bei der nächsten Ausführung als unterstes Bit in das 
nächste Langwort hineingeschoben (damit eignetsich dieser 
Befehl auch wunderbar für Laufschriften). Zurück zum Pro- 
gramm. Wir haben nun die Ergebnisse der beiden Abtastun- 
gen im Speicher stehen, jetzt müssen sie nur noch überein- 
andergelegt werden. Dies geschieht in der letzten Schleife 
(„orloop“). 

Die Routine hat allerdings zwei ‘Haken’: Zum einen funktio- 
niert die Vorgehensweise nur auf Monochrom-Bitmaps. Und 
zum anderen können mit der vorgestellten Routine nur Blök- 
ke „entfüllt“ werden, deren x-Koordinaten ein Vielfaches von 
32 sind. 





Routine: unfill 
Funktion: „entfüllen“ aller gefüllten Bildschirmbereiche 

















PROGRAMMIERTIPS 


Radieren 


Dieser Beitrag beschreibt eine Routine, mit 
der eine wichtige Standardfunktion jedes Gra- 
fikprogramms realisiert werden kann: der ‘Ra- 
diergummi’ zur Korrektur von Fehlern, die bei 
der Erstellung von Grafiken zwangsläufig vor- 
kommen. 


rinzipiell teilt sich die Routine in zwei Abschnitte: Im 
iD ersten wird die Dimension der Radierbox bestimmt. 

Danach kann sie an jeder beliebigen Position auf dem 
Bildschirm mit der Maus plaziert werden; sie markiert den zu 
löschenden Bildausschnitt. An dieser Stelle tritt die Lösch- 
box (der innere Bereich der Radierbox) in Aktion und ‘radiert’ 
den Inhalt des gewählten Ausschnitts. Damit sich der Bild- 
schirm nach eventuellen Fehllöschungen wieder restaurieren 
läßt, ist außerdem eine UNDO-Funktion vorgesehen. 


Radierbox 


Nach dem Aufruf der Prozedur Radieren erscheint am linken 
Bildschirmrand eine Box mit voreingestellter Größe. Diese 


Hendrik Haase Computersysteme 
Hard- und Software Distribution 














= 
ı  Atari-Gomputer 

Atari Mega STE und 

Atari TT Computer in unterschiedlichen Versionen 

Speed Drive 48 998,- DM 

Wechselplatte 44 1398,- DM 
| Panasonic Industriedrucker 

KXP 1540 DIN-A3 850,- DM 

HP Deskjet 500 Drucker 950,- DM 

Epson Drucker LQ 450 698,- DM 

Epson Drucker LQ 860 950,- DM 
| HP IIIP Laserdrucker 2380,— DM 

HP Ill Laserdrucker 3998,- DM 
| Farb-Multiscan-Monitor 998,- DM 
17° Monitor Flatscreen von IDEK 1998,- DM 
L AT Speed C16, - 16 MHz - 490,- DM 

Vortex ATonce, - 16 MHz - 370,- DM 

Neuheit: 

386SX Emulator für Mega STE 

Einführungsaktion 678,- DM 

Gebrauchte Atari's auf Anfrage 
Bestellungen und Informationen bei: 
Hendrik Haase Computersysteme 





Wiedfeldtstraße 77 - D-4300 Essen 1 
Telefon 0201 - 8414140 - Fax 0201 - 410421 





WRITER ST wurde speziell für Personen entwickelt, die täglich eine große Anzahl an Briefen, 
Texten, Rechnungen oder kleineren Dokumentationen schreiben müssen, wie klein- und mittel- 
ständische Betriebe. Handwerker, Ärzte und Anwälte. Durch die konsequente Einbindung in die 
graphische Benutzeroberfläche GEM ist sie für den Einsteiger leicht und schnell zu erlernen, 


© Die kommerzielle Textverarbeitung auf dem ATARI ST 

@ Rechnen und Fakturieren im Text 

® integrierte Formularverwaltung 

© Makroverwaltung mit bis zu 32.000 Makros (Artikel. Adressen.) 

© Serienbriefschreibung (Mail-Merge) mit Schnittstelle zu Datenbanken 
® vielfältige zeilen- und spaltenweise Blockoperationen 

© bis zu 4 frei belegbare Tastaturen 
® eigene Zeichensätze verwendbar 
@ lernfähiger Trennkatalog ij 
© eigene Briefkopferstellung | 
.® komfortable Druckeranpassung 

@ lauffähig auch auf Großbildschirmen 
® und vieles. vieles mehr 


komplett 189,-DM 


Burggrafenstraße 2a - D-1000 Berlin 30 
Tel.030/2650477 FAX 030/ 2650478 
Schweiz: DTZ DataTrade AG - Landstr. 1- CH-5415 Rieden/Baden - Tel 056/821880. 


Frankreich: LOG-ACCESS - 44 rue du Temple - F-75004 Paris - Tel 42777456 
Österreich: ale guten Fachhändler 


Größe kann nach Prinzip des ‘Gummibands’ (Rubberbox) mit 
der Maus auf die gewünschten Maße gebracht werden. Die 
Dimensionierung wird durch Mausklick beendet. Nun kann 
die Box (Mauszeiger am linken oberen Eck) an jeder beliebi- 
gen Stelle auf dem Bildschirm positioniert werden. 


Löschbox 


Nachdem die gewünschte Stelle angefahren wurde, wird, 
nach einem Druck auf die linke Maustaste, die von der 
Radierbox markierte Fläche gelöscht. Zuvor wird der Inhalt 
für ein eventuelles UNDO zwischengespeichert. Nun kann 
entweder durch Drücken der UNDO-Taste der Bildschirm- 
ausschnitt wieder restauriert werden, oder Sie können die 
Box an eine weitere Stelle zum Radieren (linke Maustaste 
anklicken) schieben. Ist Ihr Radiervorgang beendet, kommen 
Sie durch Anwahl der rechten Maustaste in das Hauptpro- 
gramm zurück. 





Aufruf: Radieren 

Funktion: Mit der Maus können die Größe einer 
Radierbox festgelegt und anschließend 
Bildschirmausschnitte gelöscht werden 
(Restaurierung mit UNDO-Taste möglich). 

Parameter: keine x 
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ComBasE 


Standard 

Variables Datenbanksystem 

Schneller Zugriff auch auf große Datenmengen 
Parallelbetrieb von Datenbanken, Masken, 
Listen und Zusatzprogrammen (Multitasking) 
Multiuserbetrieb in Netzen (z.B. Bionet, ATARI 
Net, PamNet) 

Mehrfachsortierung auf 4 Ebenen 
Programmierbar in drei Stufen 
Leistungsfähige Wahl- und Rechendefinitionen 
Frei definierbare Masken mit grafischen 
Elementen 


Der Unterschied 

Schnelles, ausbaufähiges Multitasking Datenbank- 
system ComBas& in einer leicht zu bedienenden 
Fensterumgebung. Dabei kann man jederzeit von 
einer Aufgabe zur nächsten umschalten (sog. Multi- 
tasking). Man muß also nicht erst eine Maske 
vollständig ausfüllen und abspeichern, bevor man 
etwas anderes tun kann, z.B. schnell nach einer 
Telefonnummer suchen. So lassen sich spezielle 
Anwendungsprogramme einfach in das ComBas£- 
System integrieren und sind jederzeit verfügbar. 


Einfache Bedienung 

Durch die grafische Bedienung erlernt man das 
Datenbanksystem in kurzer Zeit. Funktionen lassen 
sich auch mit Tastaturkommandos aufrufen. 


Geschwindigkeit 

CoMmBas£ ist schnell. Selbst bei größten Daten- 
mengen wird eine hohe Geschwindigkeit erreicht. 
Dies geschieht z.B. durch die Verwendung von 
sogenannten Schablonendateien. 


SSSSS.SSS 


Daten 

Datenbankkern: FlashAccess 

Bis zu 40 Datenbanken (Netzwerk 400) 
Max. Datensatzgröße 2 GigaByte 

Max. 65536 Indizierungen pro Datei 

Max. 2 Milliarden Datensätze pro Datei 
Index-Cache (nur durch Speicher begrenzt) 
Multiple Record-Locking 


een in 2 Stufen: 

Durch Algorithmen, einer Programmierweise, 
mit dBASE ähnlichen Befehlen, die in das 
ComBase£ System homogen eingebunden wurde. 
Diese werden durch Funktionstasten in 
Masken oder automatisch gestartet (z.B. als 
Rechenfunktion) 

Ideal für alle herkömmlichen Datenbank- 
anwendungen, Branchenprogramme, 
individuelle Lösungen... 

2. Nachladen von SPC Modula-2 Programmen, die 
das gesamte ComBaseE System mitbenutzen 
können und ’multitaskend’ neben den 
Standardwerkzeugen laufen! Komplexe externe 
Spezialprogramme (Bildbearbeitung, Geräte- 
steuerung) die auf ComBasE aufbauen. 


Frei definierbare Masken (Init) 

- Titel für Überschriften 

- Felder vom Typ Text, Zahl, Datum, Zeit, Geld, 
Radio Button, Check-Box, Logisch und Extern 
(z.B. Bilder oder andere Objekte) 

- Grafikelemente - Linien Rahmen, Füllung, 

- Makro-Taste, um einen Text auf einen Button 
zu legen (z.B. »Sehr geehrter Herr« auf den 
Button [Herr]) 

- Frei belegbare Funktionselemente, die durch 
Maus- und Funktionstasten bedient werden 
können. Mit diesen Buttons werden auch evtl. 
definierte Algorithmen ausgelöst. 


Alle Texte können in verschiedenen Font- 
größen (7-20 Punkt und, falls vorhanden auch 
GEM-Fonts) sowie in verschiedenen Farben 
dargestellt werden. 

Alle Objekte sind frei plazierbar, Masken 
beliebig groß (Fenster), Definition von 
Reihenfolge und Sichtbarkeit, virtuelle 
Felder, geschlüsselte Mehrfachfelder, 
Verbundmasken, die aus Elementen 
mehrerer Dateimasken zu- 
sammengesetzt sind. 


Datenbank Persönlich 
Dateien, Verbüunde, Algorithmen 
und alle persönlichen 
Einstellungen werden zu einem 
»Worksheet« zusammen- 
gefaßt. So kann für jeden 
Anwender ein persönliches 
Worksheet zusammen- 
gestellt werden (für 
Sekretärin, Mitarbeiter, 
Chef). Dies ist bei Multi- 
userbetrieb besonders 
wichtig. 


Worksheets/Relationen 
Jede Datei kann beliebig 
oft mit anderen Dateien in 
verschiedenen Zusammen- 
hängen verwendet werden. 
Komfortable ’REL' Funk- 
tion erlaubt durch ein- 
faches Ziehen von Ver- 
bindungen beliebige Ver- 
knüpfungen von Dateien. 
Exportrelationen erlauben 
das Übertragen von Daten 
zwischen Dateien (z.B. aus 
"Lager" in "Bestell") 


Listen und Masken 

Zu jeder Datei gehört 
mindestens ein Maskenfenster 
und ein Listenfenster, das die 
Daten editierbar in Listenform 
darstellen kann (BROWSE). Jede 
Datei hat ein eigenes Clipboard, um 
Datensätze zusammenzustellen. 











Datensicherheit 

Eine "Mirrordatei" wird auf Wunsch 

automatisch mitgeführt, um nach jeder 

Datenbankänderung ein Spiegelbild der 

ariuelen Datei auf einer anderen Partition zu 
aben. 


Datenaustausch 

Zwischen Dateien. Daten können aus der Adress- 
und Lagerdatei automatisch in eine Rechnungsdatei 
übertragen werden, um Rechnungsformulare 
auszufüllen. Diese Funktionen lassen sich auch mit 
Algorithmen programmieren. 


Export 

ASCIH IM- und Export in allen denkbaren Formaten 
(Adimens, dBase). Formate auch selbst definierbar. 
Listen und Serienbriefexport an Textverarbeitung 
wie That’s Write. Dort sind komplexe Gestaltungen 
oder Ausgabe z.B. an PostScript möglich. 


Verkaufspreis 398,- DM* 


*Unverbindlich empfohlener Verkaufspreis 


CoCom 


Ein erweiterter Desktop aus deutscher Entwicklung, 
der den bisherigen ST- und auch den TT-Desktop 
ersetzt und um viele sinnvolle Funktionen erweitert. 


Der freundliche Desktop 

Disketten- und Festplattenlaufwerke, Mülleimer, 
Drucker, Modem. Erweiterung der 
Fensterbedienung. Verschieben und Kopieren von 
Dateien. Mit und ohne Umbenennung. Gelöschte 
Dateien aus dem Papierkorb wieder retten oder 
auch endgültig löschen. Das alte ANZEIGEN/ 
/DRUCKEN/ABBRUCH wurde gegen komfortable 
Fenster mit variabler Buchstabengröße, Suchen, mit 
und ohne Zeilennummern.... auch mehrere Texte in 
verschiedenen Fenstern gleichzeitig. Bilder 
verschiedener Grafikformate werden automatisch 
erkannt und ebenfalls angezeigt. Das Drucker-Icon 
erlaubt Ausdruck mit verschiedenen Optionen, 
Rnder, Tabulatoren,... Farben für Desktop, Fenster 
und Icons können eingestellt werden. 


Eigene Icons 

Eine große Icon-Sammlung ist dabei (auch in 
Farbe). Diese kleinen Pictogramme kann man 
einzelnen, aber auch Gruppen von Dateien 
zuweisen. Vieles ist bereits voreingestellt. So findet 
man Icons für COMPO Software Produkte genauso, 
wie Symbole für viele andere Programme. Auc 
Dokumenttypen können Icons zugewiesen werden. 
DTP-Dokumente, Texte, Vektorgrafiken, 
Rastergrafiken, ... 


Aktive Icons 

Wählt man z.B. drei Texte an und schiebt diese auf 
das That’s Write Icon, wird das Programm gestartet 
und lädt diese Texte. 

Auch Datei- und Ordner-Icons können auf dem 
Desktop abgelegt werden. Dadurch entfällt 
unnötiges öffnen von Fenstern. 


Icons verschiedener Größen 

Da Icons fast beliebige Größe haben dürfen, gibt es 
neben den ’kleinen’ auch große Icons für z.B. 
Großmonitore. Natürlich auch farbig. Die Icondatei 
läßt sich mit einem RCS oder auch einem Iconeditor 
bearbeiten. 


Persönlicher Desktop 

Ein Menü erlaubt das Laden und Sichern von 
Desktop-Konfigurationen, sodaß verschiedene 
Anwender am gleichen Rechner jeweils Ihren 
persönlichen Desktop haben können. 


Tasten und Funktionstasten 

Alle Funktionen (auch in den verschiebbaren 
Dialogboxen) können per Tastatur bedient werden. 
Die Funktionstasten können mehrfach mit 
Programmen und Funktionen! belegt werden. 

Auch Fenster und Dateien können per Tastatur 
bedient werden. Dazu erscheint ein Datei-Cursor im 
Fenster. Mit Space kann man Dateien selektieren, 
mit Return starten oder Ordner öffnen, oder mit 
Insert Fenster wechseln. Selektierte Dateien bleiben 
dabei angewählt. Backspace schließt den Ordner, 
Delete das Fenster. Man entdeckt lauter 
Kleinigkeiten, die das Arbeiten sehr angenehm 
machen. Ideal z.B. für ’°STACY’ oder ’Book’ 
unterwegs ohne Maus. 


Script-Dateien 

Eine Stärke von CoCom sind Scripte, ASCIH- 
Dateien, die im Gegensatz zu herkömmlichen Batch- 
Dateien volle Kontrolle über den Desktop haben. 
Dialogboxen für Eingaben, Fenster für Ausgaben 
und Kommandos für alle Funktionen des Desktops 
grenzen an eine einfache Programmiersprache. 
Damit können Sie wiederkehrende Abläufe auf 
einen Tastendruck reduzieren. 


Der Speicherplatz 

Kein Problem, da je Programm definiert werden 
kann, ob CoCom im Speicher bleibt, oder 
ausgelagert wird. 


Für engagierte Anwender 

Per Tastendruck kann man auf einen UNIX 
angelehnten Commandointerpreter mit beachtlichen 
Befehls- und Funktionsumfang umschalten, der 
integriert ist. Eine ideale Entwicklungsumgebung. 
CoCom kennt XARG-übergabe und XACC-Protokoll 
von Accessories wie EasyBase oder That’s Address. 


Pull-Down-Menüs 

Diese beschränken sich auf Voreinstellungen, sowie 
Anmelden von allen/einem Laufwerk und 
Werkzeugen, sowie Konfiguration der Icons. Alles 
Wichtige geschieht ber ’PopUp’ an Ort und Stelle: 
Unnötige Mausbewegungen werden so drastisch 
reduziert. 


Pop-Up Menüs 

CoCom PopUp Menüs erkennen Ihre Umgebung. 
Das bringt übersicht und vereinfacht die Bedienung 
noch mehr. Die Menüs erkennen, wann Sie 
angefordert werden und bieten nur die passenden 
Optionen an. Auf Disketten zeigt das PopUp 
Optionen von der Anzeige des freien Platzes, über 
Diskcopy, Virenschutz bis Löschen und Formatieren 
(auch HD- und Fett-Option -voreinstellbar). Auf 
Festplattenicon dagegen zeigt das PopUp eine 
schnelle DateiSuchfunktion, Directory-Tree, 
Datensicherung, Platz-Statistik... Auch Fenster und 
Ordner haben ein eigenes PopUp mit Dateimaske 
(zeigt nur noch bestimmte Dateien), Sortieren und 
Darstellungsart (Icons oder Text, mit/ohne Datum, 
Länge, Attribute....). 


Lieferumfang und Hardware-Unterstützung 
Neben Handbuch und Programm liegt eine Diskette 
bei mit einer sinnvollen Grundausstattung an 
Hilfsprogrammen wie Archivierer, Backup, 
Kopierprogramm,... Natürlich können auch eigene 
Programme eingebunden werden. 

Alle ATARI ST/STACY/STE/TT mit Festplatte. 
Auflösungen ab 640x200 Punkte Monochrom und 
Farbe. Farbschirme, Großbildschirme, MegaScreen 
und OverScan werden unterstützt. 


Firmen, Entwickler, EDV-Berater, Händler, 
CoCom gibt es auch als OEM-Lizenz-Software 
durch den CoCom-Compiler erhalten Sie die 
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Farbpalettenwechsel 


Die in diesem Artikel vorgestellten Demopro- 
gramme sollen zeigen, wie Sie in Ihren Pro- 
grammen Farbpalettenänderungen benutzen 
können, um Zeichnungen zu animieren oder 
Farbeffekte auf dem Monitor darzustellen. 


Christen Fihl 


enn man auf dem Bildschirm zeichnet, ist es not- 
W wendig, die Farbe anzugeben, mit der gezeichnet 

werden soll. Die Farbnummer (0 bis 15) wird nicht 
direkt angezeigt, sondern zeigt auf den entsprechenden 
Inhalt einer Farbpalettenzelle. Die dort stehende Farbe er- 
scheint dann auf dem Monitor. Um nun die Farbe eines 
Bildschirmpunktes zu ändern, ist es nicht notwendig, ihn neu 
zu zeichnen, sondern nur den Inhalt der Palettenzelle zu 
ändern. Allerdings werden dann auch alle anderen Pixel, 
deren Farbwert auf diese Zelle zeigt, in der neuen Farbe 
abgebildet! 

Für Animationen ist es charakteristisch, daß Bilder auf dem 
Monitor schnell wechseln, ohne daß man sieht, wie sie 
aufgebaut werden. Dieser Effekt ist z.B. dadurch möglich, 
daß man die Farbpalette ändert. Natürlich dauert es immer 
noch genauso lange, ein Bild aufzubauen, aber der Effekt läßt 
sich für den Anwender des Programms unsichtbar program- 
mieren. (Eine andere Möglichkeit bietet die Verwendung von 
mehreren Bildschirmen, von denen einer gezeigt wird, wäh- 
rend auf den anderen gezeichnet wird; siehe Artikel über 
Hintergrundprogrammierung im Grundlagenteil dieses Son- 
derhefts.) 





Um unsichtbare Linien zu ziehen, muß die Farbe der Linie mit 
der des Hintergrunds übereinstimmen. Deshalb ist es not- 
wendig, die Anzahl der Farben auf zwei oder vier zu be- 
schränken. Im Beispiel-Animationsprogramm werden vier 
Farben benutzt, was bedeutet, daß zwei Figuren animiert 
werden können (4*4 = 16 Farben). Durch die Benutzung von 
lediglich 2 Farben lassen sich vier Figuren animieren (2*2*2*2). 

Nehmen wir an, daß zwei Figuren auf dem Bildschirm zur 
Darstellung kommen. Wir wollen die Bilder jeweils einzeln 
anzeigen. Das erste Bild wird in den Farben 0, 1, 2 und 3 
dargestellt, das andere in den Farben 0, 4, 8, 12. Beim Aufbau 
des Bildes muß der Schreibmodus entweder aufOR oder auf 
XOR gestellt werden. Dadurch verhindert man, daß das 
zweite Bild das erste zerstört. 

Durch das Tauschen der Farbpaletten (hierbei bezeichnet 
F1 die erste Farbe, F2 die zweite und so weiter) [F1, F2, F3, 
FA, F1,F2, F3, F4, F1,F2, F3, F4, F1,F2, F3, F4], [F1, F1, F1, 
F1,F2,F2,F2, F2, F3, F3, F3, F3, F4, F4, F4, F4] und [F1, F2, 
F3, F4, F3, F2, F3, F4, F3, F2, F3, F4, F1, F2, F3, F4] können 
beide Bilder separat angezeigt werden. Die erste Palette 
stellt nur Bild 1 dar. Hierzu muß für alle Farbbitkombinatio- 
nen, die den selben Farbwert des Bildes enthalten auch die 
gleiche Farbe gesetzt werden. Dadurch ergaben sich die 
Kombinationen —00 (0, 4, 8, 12), —01 (1, 5, 9, 13), —10 (2, 
6, 10, 14) und —11 (3, 7, 11, 15). Bild 2 wird durch die zweite 
Farbpalette angezeigt [Farben: 00— (0, 1, 2, 3), 01— (4,5, 6, 
7), 10— (8, 9, 10, 11) und 11— (12, 13, 14 15)]. Diese Werte 
kamen zustande durch das Prüfen der Bitpattern, die mit 4 
Bits möglich sind. Das erste Bild benutzt dabei die Bits 1 und 
0 (XX), während das andere die Bits 3 und 2 (YY) verwendet. 
Die möglichen Kombinationen sind dabei YYOO, YYO1,YY10, 
YY11 (Farben des Pixels des ersten Bildes, bei beliebiger 
Farbe (des gleichen Bildpunktes) des zweiten Bildes) und 
00XX, 01XX, 10%XX, 11XX. 

Das Animationsprogramm schaltet zwischen zwei Bildern 
hin und her. Das Palettenprogramm erstellt einige psychede- 
lische Grafiken. Beide Programme setzen natürlich einen 
Farbmonitor voraus. 
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Systemerweiterungen 


Im Grundlagenteil finden Sie eine Reihe von Artikeln, die sich mit der Programmierung mittels Betriebssystemfunk- 
tionen beschäftigen. Ein Schwerpunkt liegt dort in der GEM-Programmierung. Auf den folgenden Seiten finden Sie 
7 Beiträge, die sich damit befassen, wie man mehr aus dem Betriebssystem herausholen bzw. wie man es ergänzen 
kann. So stellen wir Ihnen eine Library zur Dialogboxbehandlung, die neben den Standard- auch Dialoge mit 
beweglichen und Pop-Up-Boxen durchführen kann, vor. Desweiteren besprechen wir Routinen zu den Themen 
effiziente Speicherverwaltung und weiteren interessanten Programmierbereichen. 
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Ausgabeumlenkung 


via BIOS 


Wem geht es nicht ab und an so: Man hat ein 
schönes Programm, das ebenso schöne Grafi- 
ken im Vektorformat erzeugt und daher ewig 
langsam im Ausdruck ist? Oder man program- 
miertfürseine serielle Schnittstelle eineneue, 
extremschnelle Übertragungsroutine, dieaber 
nicht ganz richtig funktioniert. Leider braucht 
man zum Testen einen zweiten Rechner, und 
der Freund ist ganz schön sauer ob der für ihn 
nicht nutzbaren Zeit. 





NTFAUNG 


ie schön wäre es, könnte man den Drucker oder die 
serielle Schnittstelle durch die Tastatur oder eine Datei 
oder ... ersetzen. Der erfahrene ST-COMPUTER-Le- 


ser wird sagen: Dafür gibts doch die GEM-DOS-Funktion $46 
Fforce(). Stimmt ja auch, aber... 


Fforce() 


An dieser Funktion störten mich schon lange drei Mängel: 


1. Es können nur GEMDOS-Funktionen umgelenkt werden. 

2. Es wird nicht nach Ein-und Ausgabefunktionen unter- 
schieden (außer CON:). 

3. Es können auch nicht alle verfügbaren Geräte umgelenkt 
werden (z.B. MIDI). 


Was lag näher, als sich den Assembler zu nehmen und sich 
der Sache anzunehmen? Aber zunächst einmal zu den be- 
kannten Sachen, sprich Fforce(). 

Diese GEMDOS-Funktion bewirkt wie bekannt das Umlen- 
ken von Geräten in andere Geräte oder Dateien. Ein kurzes 
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Beispiel in C: 


#define CON_IN 0 

#define CON_OUT ı 

#define AUX 2 

#define PRN 3 

/* womit wir auch schon 
alle behandelbaren 
Geräte erwähnt hätten */ 


main() 

t 
int han; 
han=Fcreate ("test.dat",0); 
Fforce (PRN,han); 
Cprnout('a'); 
Fclose (han); 
return 0; 


} 


Es passiert im Programm nichts weiter, als daß die Datei 
TEST.DAT geöffnet und der Drucker dorthin umgelenkt wird. 
Wenn nun ein Zeichen auf den Drucker ausgegeben wird, 
landet es nicht auf diesem, sondern in unserer Datei, und 
man kann in der Datei nach Beenden des Programmes den 
Buchstaben ‘a’ bewundern. So weit, so gut. Jetzt weiß ich 
also, wie ich in meinem eigenen Programm den Drucker 
„verbiege“. Das hilft mir aber beim Grafikprogramm nicht 
weiter. Schließlich habe ich das nicht selbst geschrieben und 
der Hersteller wird wohl auch kaum den Quelltext verschik- 
ken. Die Hilfe ist einfach: Diese „Geräteverbiegung“ kann 
weitervererbt werden. Ersetzt man also das 


Cprnout('a') 
im Beispiel durch z.B. 


Pexec ("graphik.prg",command, "",0) 


so wird GRAPHIK.PRG gestartet und die Grafik, diesonst auf 
dem Drucker gelandet wäre, liegt dann in unserer Datei, wo 
sie ja gut aufgehoben ist. Nachdem unser Programm been- 
det wurde, ist wieder alles in bester Ordnung, das Betriebs- 
system sorgt selbst dafür, daß der Drucker druckt und nicht 
mehr „dateit“. Und wie druckeich dann das ganze aus? Ganz 
einfach: vom Desktop aus die Datei zweimal anklicken und 





Computer & Electronic & Zubehör HERGES 
Obere Rischbachstraße 88 » 6670 St. ‚ngbent 
Telefon (06894) 3831 78 / Telefax (06894) 382855 












Computer + Erweiterungen: 

Vene, 1MBRAM, Floppy 720KB, Maus, Zub.DM 1378.— 

MegaSTE, 2MB RAM, Floppy 720KB, Maus, Zub. DM 1498,- | Mi 

MegaSTE, AMB RAM, Floppy 720KB, Maus, Zub. DM 1748,- 
2, 2MBRAM, KB Mas zu DM 208 | FDc 





E 0 > 

RPS-CISUhr ...DM 28.- 
68881+PalSTE „DM 188.- 
T0S 1.4(6Rom) .DM 188.- 
1 NB-Simm8 ... DM 118,- 
Drum-Kit804 ...DM 358,— 
Drum-Kit 605 -.. DM 278.- 
TonerSLM-804 „DM 89- 
Toner SLM-605 „DM B9- 









Lieferung erfolgt: 


Bausatz eos a), 
NurL apa, Inkl Bestückungen 
Gal 16VB-2SL (Sockel lür 16V8 DM -, 
al 20V8-2SL (Sockel für 20v8 DI 


Arrköine Schechs*"" 
Bei Vorkasse zuerst Lieerzeit 
18,- | derWarzeragen! 


I 
1880 





E-Prom 27C010-200 ns, Progr.Sp. 12,5V u... 
‚Andere E-Proms + IC-SockelällerAft..... 














aA 
E Nur gegen Termin Selbstabholung ----- Alle Angebale Ieibleibend —-- 








»RETOUCHE PRO 






BELICHTEN SIE. 
AUF ATARI! 





OTTO-HAHN-STR. 1 : 6337 LEUN 1 
FON 06473/2061 - FAX 06473/3101 


Wir suchen 


einen Techniker/ 
eine Technikerin 


für alle 
ATARI-Produkte 


KFC Computer 
Wiesenstraße 18 
6240 Königstein 1 
Tel. 0 61 74 - 30 33 



































UNVERZICHTBAR 
FÜR DIP UND CAD 





&eniScan 
32 UND 256 GRAUSTUFEN 


INCL. BILDBEARBEITUNGSSOFTWARE 
AB DM 598,- 





ISTAN COLOR 


FLACHBETTSCANNER 


300 DPI/SCSI 

PHYS. GAMMAKORREKTUR 

AUTOM. WEISSABSLEICH 

16,7 MILLIONEN FARBEN BILDBEARBEITUNGSSOFTWARE 


DM 3699,- 


iUS 
TRIPLE MOUSE 


350 DPI 
DM 59,- 


SIRIUS 
Computer GmbH 
SIRIUS 
Arheilger Weg 6 
D-6101 Roßdorf 
Tel.: 06154-9053 
Fax: 06154-83244 


HÄNDLERANFRAGEN ERWÜNSCHT 


gekommen ist"eme ei 


Fordern Sie Infos a 











ungen aller Grafike) 
Stichwortverzeichnis 
finden der gesuchten 
Utilitydisk zum 


Den Katalog erhalten Sie im stabilen A4 
Ordner zusammen. mit den 26 Disks für 
=> 


° 


ie Grafiksammlung, 

. von) verschiedenen 

ammlüng gezeichnet. 

iS K gute Verwendbarkeit 


imTE 1 ien die Motive mit 


den Ze jrochen. Heraus- 
€ ahlige Grafik: 
ollection, die keinem DTP!er fehlen sollte 
& Grafiken (ca 
00) liegen im N IMG 
Format vor. Mit ge 

DM 149.- du 


Verwendung in allen 
die das CFN-Format 
us, SL, Didot). Beinahe 
' liegen als Fontfamilier 


epfün jede Layout- Aufgabe 
satz | 


j Hafenstr. 16, 2305 Heiken« 


1/241247, Fax 
ah - c Re 





41992 STSondernet 101 








PROGRAMMIERTIPS 


die Frage ansehen | drucken | Abbruch mit „drucken“ beant- 
worten. Dann geht die Post ab, und der Drucker wirft die 
schönste Grafik aufs Papier. Damit hätten wir also die einfa- 
che Lösung kurz nochmal abgeschnitten. Aber wie gesagt, 
das funktioniert sofort nicht mehr, wenn unser Grafikpro- 
gramm die Grafik mittels BIOS ausgibt. Dann müssen wir 
nach wie vor eine halbe Stunde Rechenzeit in Kauf nehmen. 
Und für andere Anwendungen bestehen immer noch die 
oben genannten Mängel. Und hier setzt mein BIOS.PRG an. 


Jetzt komme ich 


Was eigentlich das Programm bewirken soll, ist ja nun klar. 
Und weil ich Fforce() nicht für so schlecht halte, sollte die 
Wirkung auch ähnlich sein. Ich habe also extra für dieses 
kleine Programm eine neue BIOS-Funktion implementiert, 
die bei mir Bforce() heißt und die Dateiumlenkung auf BIOS- 
Ebene bewirkt und im Gegensatz zu Fforce() auch noch 
zwischen Ein- und Ausgabe unterscheidet. Folglich gibt es 
drei Parameter: 


1. der umzulenkende Kanal 
2. wohin der Kanal umzulenken ist 
3. ob Ein- oder Ausgabe gemeint ist 


Um das Kapitel der Benutzung gleich ganz abzuhaken, nun 
noch das Schema des Aufrufs der Funktion in C und Assem- 
bler: 


#define Bforce(a,b,c) bios(132,a,b,c) 
Bforce (device,newdevice, in_out); 
move.w in_out,-(sp) 

move.w newdev,-(sp) 

move.w device,-(sp) 

move.w #132, -(sp) 

trap #13 

addq.l #8,sp 


Die Parameter haben dabei folgende Bedeutung: 


in_out: 0 - Eingabe umlenken 
1 - Ausgabe umlenken 
newdev:BIOS- bzw. Datei-Handle des Umlenkungszieles 
device: BIOS-Handle des umzuleitenden Kanales. Ist new 
dev: größer oder gleich sechs, handelt es sich um ein 
Datei-Handle, sonst um eines der folgenden BIOS- 
Handles. 


0 Drucker 

1 serielle Schnittstelle 
2 Konsole 

3 MIDI 

4 IKBD 

5 RAW-Konsole 


Datei-Handles sind automatisch größer als sechs, darüber 
braucht man sich also keine Sorgen zu machen. Wen jetzt die 
technischen Feinheiten nicht interessieren (sog. Nutzer), der 
kann aufhören zu lesen. Allerdings sollte er sich die Warnun- 
gen am Ende des Textes noch durchlesen. 
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Programmierung 


Dem geehrten Leser stehen natürlich noch alle anderen 
Wege offen. Aber so funktioniert es in etwa: Mit einer Funk- 
tion namens install klinke ich mich in den BIOS-Vektor 
(XBRA-Verfahren; siehe Artikel in diesem Heft) und fange 
erstmal alle BIOS-Aufrufe ab. Danach werden alle mich 
interessierenden Funktionen ausgefiltert, als da wären 


Name Nummer 
1. Bconstat 0 
2. Bconin 2 
3. Bconout 3 
4. Bcostat 8 
5. Bforce 132 


Das sind alle BIOS-Funktionen, die mit Ein-und Ausgabe auf 
Geräte zu tun haben. 1. und 4. sind Erkundigungsfunktionen, 
die den Status von Geräten feststellen, 2. und 3. sind die Ein- 
und Ausgabefunktionen, und 5. schließlich ist hier gerade im 
Entstehen. Zuerst beschäftigen wir uns mit 5. 

Wird diese Funktion aufgerufen, wird anhand von device in 
die Ein- oder Ausgabetabelle der Wert von newdev eingetra- 
gen. device wird dabei als Offset in der Tabelle verwendet. 

Wird nun allerdings 1., 2., 3. oder 4. erkannt, liegt als 
Funktionsparameter auch immer die device-Nummer auf 
dem Stack. Diese wird vom neuen BIOS-Handler als Offset 
in die Ein- oder Ausgabetabelle verwendet und die dort 
stehende Nummer anstelle des alten Wertes auf den Stack 
gelegt. Kurz gesagt, wird die Funktionsnummer ausgetauscht. 
Danach wird der BIOS-Aufruf weitergeleitetan den ursprüng- 
lichen BIOS-Handler, der dann ganz unbekümmert mit dem 
untergemogelten Gerät weitermacht, als wäre nichts pas- 
siert. Das Programm, das den Aufruf tätigt, bekommt auch 
nichts von der kleinen Manipulation mit. 

So wie bis hier dargestellt, funktioniert das ganze aber nur 
für Umleitungen innerhalb der sechs BIOS-Kanäle. In Datei- 
en kann man damit aber noch nichts schreiben. Da aber 
Datei-Handles gut zu erkennen sind (>=6), wird in diesem Fall 
wie folgt vorgegangen: 


Umleitung in Dateien 


Für Ein- oder Ausgabefunktionen wird die in der Tabelle 
gefundene neue Gerätenummer als Datei-Handle erkannt 
und zur weiteren Bearbeitung das GEMDOS genutzt. Derzur 
Ausgabe vorgesehene Wert wird also in einen Ein-Byte- 
Puffer übertragen und mittels Fwrite() in die ausgewählte 
Datei ausgegeben. Bei der Eingabe wird der einzulesende 
Wert mittels Fread() in den Puffer eingelesen und danach in 
DO übertragen, wo das BIOS alle Funktionswerte zurückgibt. 
Die Erkundigungsfunktionen sind in diesem Fallnur Dummy- 
Funktionen, da sie immer wahr zurückgeben. Es gibt also hier 
einen „Rückschritt“ vom BIOS zum GEMDOS, der allerdings 
nicht ganz problemlos funktioniert, da das GEMDOS auf das 
BIOS zurückgreift. Wenn nämlich ein BIOS-Aufruf des GEM- 
DOS erfolgt, und dieses wiederum das GEMDOS konsultiert, 
werden die internen Speicher des GEMDOS gnadenlos über- 
schrieben, und man kriegt das große Grübeln, wo plötzlich 
die ganzen Bomben herkommen. Aber. man kann sich ja 
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helfen. Die Lösung ist zwar nichtso ganz elegant, funktioniert 
aber. Es wird nämlich auch noch der GEMDOS-Vektor über- 
wacht, und sobald eine Funktion [außer Pexec()] angesprun- 
gen wird, ignoriert unsere BIOS-Routine alle Umleitungen in 
Dateien, so daß das GEMDOS ungestört arbeiten kann. 
Dadurch ist zwar die Umleitung nicht mehr ganz so mächtig, 
aber dafür sicherer. 

Das war's im Prinzip auch schon. Als Zugabe ist noch ein 
kleines Programm dabei, das die BIOS-Routine resident im 
Speicher ablegt. Und zum Schluß nun noch die versproche- 
nen Warnungen. 


Achtung! 


Als wichtigstes und allgemeinstes: am BIOS führt (fast) kein 
Weg vorbei. Eine Umlenkung von Kanälen wirkt sich also 
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Der Diskutant 


überall aus, selbst bei solchen Sachen wie der Fileselectbox! 
Also Vorsicht bei der Anwendung, insbesondere bei Umlen- 
kung der Standardeingabe. Des weiteren ist zu beachten, 
daß nicht alle BIOS-Funktionen für alle Geräte implementiert 
sind. Die hier vorgestellte Routine kümmert sich um solche 
Feinheiten nicht, aber die Original-BIOS-Fehlermeldungen 
kommen zurück. Das gilt nicht bei der Umlenkung in Dateien. 
Man sollte also immer sehen, daß die Dateiarbeit reibungsfrei 
ablaufen kann. Des weiteren macht das Betriebssystem die 
Veränderung der Kanäle nicht selbständig wieder rückgän- 
gig, sondern der Nutzer muß das selbst machen [mit Bforce 
(device, device,in_out)]. Sonst bleibt alles bestehen bis zum 
nächsten Reset. Die Funktionen install() und exstall(), sollte 
sie jemand in einem eigenen Programm nutzen wollen, 
müssen im Supervisormodus aufgerufen werden. 
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Erstellen Sie im Handumdrehen professionelle 
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_ CONVERT & Co 


Alle Preise in DM 


CONVERT 2 DER Grafikkonverter mit 
den meisten Formaten (über 80), jetzt auch 
Farbe»Grau, 2/4/8bit Grau, Druckraster... 
Scarabus 3 DER Fonteditor für S!2- 
Fonts, jetzt bel. große Grafik als Vorlage, 
viele neue Profi-Bearbeitungsmöglichkeiten 
Headline 4 DAS Überschriftenprog. 
für S!2-, GEM- und die GROSSEN Headline- 
Fonts, völlig neu programmiert 

mit über 40 GROSSEN Fonts 175 120 
SDO-Bundle DAS Paket der S!2-Tools 150 100 
Graph, Image, Index, Merge und Preview. x50 
Holen Sie das Letzte aus Signum? raus... 
*100.-, wenn Sie eins upgraden, 50.- bei 2 und mehr! 


.„.. und Vecto] 50, II 95, 1stEuro 
Yer Wen 50, Grafkchletvonu 38 
Apızaft as Pimer Software 


Bundesallee 56, 1000 Berlin 31 
(030) 8534350 Fax 8533025 

GratisInfos anfordern ! 
N=NEU U=UPGRADE (Alte Originaldisk senden!) 
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Dauerhaftes MALLOC 
für Accessories 


Diejenigen, die schon einmal Accessories 
programmiert haben, mußten sich, sobald 
diese etwas komplexer wurden, bestimmt 
schon mit dem Problem herumschlagen, daß 
man die GEMDOS-Funktion MALLOGC zur Spei- 
cherreservierung nicht so einfach anwenden 
kann wie in ‘normalen’ Programmen. 


Lutz Preßler 


Hauptprogramms automatisch auch alle mit MAL- 

LOC( reservierten Speicherbereiche des Accesso- 
ries freigegeben werden, wenn diese während der Laufzeit 
des Hauptprogramms reserviert wurden. Daraus folgt, daß 
spätestens beim Eintreffen der AC_CLOSE-Message alle 
reservierten Speicherbereiche wieder zurückgegeben wer- 
den müssen. Wenn man nun aber z.B. eine Adreßverwaltung 
als Accessory schreiben wollte, hieße das, daß deren Funk- 
tion stark eingeschränkt würde, da die Adressen bei jedem 
Programmende wieder gelöscht werden müßten. Und nicht 
nur dann: Die AC_CLOSE-Message wird nicht nur beim 
Beenden eines Programms gesendet, sondern auch beim 
Starten eines solchen. Da ich keinen Weg kenne, festzustel- 
len, ob nun ein Programm wirklich beendet wurde, muß man 
zwangsläufig auch beim Starten eines Programms den Spei- 
cher freigeben, obwohl das eigentlich gar nicht nötig wäre. 


M an muß nämlich beachten, daß beim Beenden eines 


Speicherverwaltung 


Das Ganzeiist also wirklich nicht sehr befriedigend. Man fragt 
sich, ob es da nicht irgendeine Möglichkeit gibt, das Freige- 
ben der Speicherbereiche zu verhindern. Dazu muß manssich 
erst einmal im klaren sein, warum es überhaupt zur Freigabe 
kommt, was das Betriebssystem also macht. Die Wurzel 
allen Übels ist, daß Accessories zwar eigene AES-Applikatio- 
nen sind, aber leider unter GEMDOS keine eigenen Prozesse. 
Sie haben deshalb zum Beispiel auch keine vollständig 
gefüllte Basepage (die man aber trotzdem verwenden kann, 
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s.u.). Das Accessory ist für GEMDOS also der gleiche Prozeß 
wie das gerade aktive Hauptprogramm. Nun ist es so, daß 
GEMDOS intern bei jedem allokierten Speicherbereich ver- 
merkt, zu welchem Prozeß er gehört, indem er einen Zeiger 
auf dessen PD (Basepage) abspeichert. Beim Ende des 
Hauptprogramms durch Pterm/PtermO werden nun seiner- 
seits alle Speicherbereiche freigegeben, die diesem PD zu- 
geordnet sind. (Für genauere Informationen verweise ich auf 
[1].) Dies ist im allgemeinen ja auch ganz sinnvoll, da bei 
normalen Programmen nach dem Ende der Speicher nicht 
mehr benötigt wird. Für residente Treiber usw. steht dann 
Ptermres() zur Verfügung, wo kein Speicher freigegeben 
wird. Durch den ‘Designfehler’ im TOS werden nun aber auch 
die Speicherbereiche der Accessories freigegeben, und das 
ist ja gerade unser Problem. Wie kann man es lösen oder 
umgehen? Dazu muß man wissen, daß es eine GEMDOS- 
Variable namens act_pd gibt, die immer die Adresse des PD 
des gerade aktiven Prozesses enthält (sprich einen Zeiger auf 
die Basepage des Hauptprogrammes). Wenn per Pexec() ein 
Programm gestartet wird, zeigt act_pd danach auf dieses 
Programm, nach Programmende wieder auf den ‘Elternpro- 
zeß’. BeiMALLOC() und Pterm() wirdnunact_pd benutzt, um 
die Zugehörigkeit der Speicherblöcke festzustellen. Haben 
Sie schon einen Lösungsvorschlag? Sehr gut! 


Speicher sichern 


Ja, die Idee ist wirklich, act_pd vor einem Accessory-MAL- 
LOC- (bzw. Mfree-) Aufruf umzusetzen (und zwar auf die 
Basepage des Accessories) und danach sofort wieder zu- 
rück. Die Folge ist, daß bei einem späteren Pterm() die vom 





Aufruf: accmalloc(amount) 


Funktion: reserviert Speicher am Ende des freien 
Bereichs (für Accessories!) 
Parameter: amount: benötigter Speicher 


Rückgabewert: Zeiger aufStartadresse des reservierten 
Speichers; bei aufgetretenem Fehler 0 







Aufruf: accmfree(ptr) 

Funktion: gibt mit accmalloc() reservierten 
Speicher wieder frei ee 

Parameter: ptr: Anfangsadresse des freizug 


den Speicherbereichs 
[Rückgabewert von accmalioc)] 
Rückgabewert: O0: alles ok; un 2 
-40: Speicherblock wurde nicht mit 
(acc)malloc{) reserviert 
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IBM-PC Bus 


EPROM-Bank 


für max 2 autstartähige 
Programme, 2.B. super 
schnelle, bootähige 


Neu yezt mit Hard-Disk-Triber 
Nutzen Se eine preiswerte IBM- 
Hard.isk! Auch sehr große Pal- 
ten (ger 100 Mäyte) werden 
uersützt. Bolen Sie direkt von 
(er Platte. Dör DMA-Port bibt 


Loerplatine (bis 512 KByte) 
PLD (programmiert dazu) 
Bausatz komplett 

fertig aufgebaut, getestet 
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Accessory reservierten Speicherbereiche nicht mehr freige- 
geben werden, da sie ja nicht mehr dem Hauptprogramm 
zugeordnet sind. Ein paar ‘Details’ sind aber trotzdem noch 
zu besprechen, bevor Sie diesen Weg ausprobieren können. 
Vor allem habe ich bis jetzt immer nur von von act_pd 
gesprochen, aber nicht gesagt, wo diese Speicherzelle liegt. 
Leider ist es nämlich nicht ganz so einfach wie bei den 
meisten anderen Systemvariablen, dieschon seit Urzeiten (in 
diesem Fall 1985) von ATARI garantiert wurden. act. _pd war 
bis zurROM-TOS-Version 1.0 undokumentiert, lag allerdings 
immer an der gleichen Adresse. Diese änderte sich beim 
‘Blitter-TOS’ 1.2 zwar, doch hatte ATARI eingesehen, daß 
act_pd eigentlich doch ganz nützlich sein könnte, und erwei- 
terte den Systemheader u.a. dahingehend, daß ein Zeigerauf 
act_pd enthalten ist. Man muß also anhand der TOS-Version 
(ebenfalls im Systemheader) unterscheiden, ob ein ‘altes’ 
TOS vorhanden ist, und die Adresse von act_pd entspre- 
chend bestimmen. An dieser Stelle muß ich nun auch einräu- 
men, daß das hier beschriebene Verfahren zwar recht sauber 
ist und auch auf allen TOS-Versionen funktioniert, aber nicht 
ausschließlich nur dokumentierte Eigenschaften benutzt. 
Das größte potentielle Problem ist, daßact_pd von ATARInur 
zum Auslesen freigegeben wurde, der Schreibzugriff ist 
eigentlich nicht erlaubt. Da act_pd aber ja nur für sehr kurze 
Zeit (ein paar GEMDOS-Aufrufe) geändert wird, könnte das 
höchstens bei zukünftigen Multitasking-Versionen des GEM- 
DOS/TOS zu Problemen führen. Eine andere Einschränkung 
ist, daß nirgendwo dokumentiert ist, daß für die Zuordnung 
der Speicherblöcke zu den Prozessen act_pd benutzt wird. 
Eine andere Möglichkeit kann ich mir allerdings fast gar nicht 
vorstellen. Wie gesagt, diese Einwände habe ich nur der 
Korrektheit wegen aufgeführt. 


Speichermangel? 


Viel wichtigerist dagegen folgendes: Wenn Sie das Verfahren 
so anwenden würden, wie ich es bis jetzt beschrieben habe, 
würden Sie sich evtl. bald über scheinbar unerklärlichen 
Speicherplatzmangel wundern, und zwar ironischerweise 
gerade bei Gebrauch von sauber geschriebenen Program- 
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ECB Bus ‚gend für wissensch. Meßwerterfassung, Sound-Sampling usw. geeignet! 
Parallelport Üppige Ausstattung: mit 8 Kanal Multiplexer, programmierbarem Instru- 
bis 1 MByte mentenverstärker und schnellem Sample/Hold. 
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Bausatz komplett incl. Plat. (1 D/A Kanal) 
Fertigkarte mit schnellerem A/D (154). 
1.D/A, geprüft & abgeglichen 


Unser Renner: 















87- 
3,- 
169,- 
228,- 


Huckepackpiatine für 1 MByte 22,- 
‚dto. bestückt 3, 

‚EPROM-Floppy Software ir 
Hard-Disk-Treiber mit Quelle 15;- 


Technik. 

Bausatz (Platine, IC’s, C’s) (Löterfahrung erl.!) 
Fertigkarte mit Pfostenstecker und 0,5 m 
Flachbandkabel (beidseitig Federleiste) 








-D/A Wandler 


Ein neuer Leckerbissen für alle STs: schneller (25 us oder 15 zus) MD Wand- 
4D/A Wandler (4 5) auf einer Europakarte (c't 9/88). Hervorra- 


Perfekte Konstruktion, z.B. drei getrennte Masseführungen: bis ins letzte 
Bit genau, das ist in dieser Preisklasse schon etwas Besonderes. Keine Pro- 
bleme mit Rauschen, Nichtlinearitäten, usw. Also gut 20mal genauer als ein 
analoges Multimeter! Anschluß an ST über ROM-Port Buffer mit Flachband- 


‚Aus Qualitätsgründen verwenden wir nur original Burr-Brown Chips! 


Spezial-ICs (A/D, D/A, InVerst., MUX, S/H: 5 ICs) 


'ROM-Port Buffer: puffert alle Leitungen des ROM-Ports. Schützt den ST 
und ermöglicht den Anschluß von ROM-Karten per Flachbandkabel. In SMD- 


men. Was ich meine? Stellen Sie sich folgende Situation vor: 
Sie starten ein Programm, das ganz korrekt seinen über- 
schüssigen Speicher wieder zurückgibt. Dort rufen Sie nun 
ihr Accessory auf, das nach obigem Verfahren ‘dauerhaft’ 
Speicher reserviert. Dann beenden Sie das Hauptprogramm. 
Der Accessory-Speicher ist immer noch unverändert erhal- 
ten. Also alles in Butter? Leider nicht ganz. Fragen Sie nun 
einmal den ‘freien’ Speicher ab (MALLOC(-1)). Er wird über- 
mäßig stark geschrumpft sein. Was ist passiert? Das Pro- 
gramm hatte seinen überflüssigen Speicher zurückgegeben. 
Das Accessory hat sich nun den Anfang dieses Speicher- 
blocks ‘dauerhaft’ reserviert. Wenn das Programm dann 
beendet wird, wird dieser ja nicht mehr freigegeben und 
damit der große freie Speicherblock in zwei Teile geteilt. 
Davon wird dann für das nächste Programm nur noch die 
größere Hälfte benutzt. Diese Situation ist natürlich inakzep- 
tabel, was kann man also machen? Man müßte dafür sorgen, 
daß das Accessory nicht den Anfang sondern das Ende des 
freien Bereichs zugeteilt bekommt. Dann würde beim Pro- 
grammende nur soviel Speicher fehlen, wie wirklich ge- 
braucht wird. Dies ist mit einem weiteren Trick auch möglich: 
Es wird einfach der gesamte freie Speicher abzüglich der 
gewünschten Größe reserviert. Danach wird der eigentliche 
Speicherblock reserviert und im Anschluß daran der erste 
‘Hilfsblock’ wieder freigegeben. Dieses Vorgehen erzielt den 
gewünschten Effekt, ist legal und hat noch zu keinen Proble- 
men geführt. 

Ich hoffe, daß diese Routinen für einige nützlich sind und 
vielleicht die Erstellung von umfangreicheren Accessories 
erleichtern. Eventuell habeich hiermit jasogar den Anstoß zu 
ganz neuen Projekten gegeben, was mich sehr freuen würde. 


Verwendete Literatur: 


[1] ST-Computer Sonderheft Nr.2 (1987): 
TOS intern (Alex Esser, S. 35 ff.) 

[2] Reschke/Jankowski/Rabich: 

ATARI ST Profibuch Sybex, 

Düsseldorf 






















ROM-Port 
Expander 


Das Bussystem für den 
ROM-Port 


Mit unserer neuen Platine erweitern Sie Ihren 
ST auf zwei ROM-Ports. Sie wird ohne jede 
Lötarbeit an das Flachbandkabel des Buffers 
angeschlossen. Durch einfachen Anschluß 
‚einer zusätzlichen Platine Erweiterung auf vier Slots, 

Umschaltung automatisch per Software oder manuell per Taster. Gut geeig- 
net auch für Einbau in PC-Gehäuse 




















DM zus Pie: 

DM 448,— Leerplatine DM 39, — GAL2OVB (programmiert) dazu DM 28,— 
Bausatz, kompl. DM105,— Fertigkarte getestet DM 138,— 

DM 645,— 'ATAR| ROM-Port Buchse (40pdl., 2 mm Raster) einzeln DM 13,20 


Issenporrr Mikroelektronik 


Dipl.-Ing. Eberhard Issendortf 
Wellweg 93 


DM 45,— 
“ 3203 Sarstedt 





Tel. 050 66/998 76 


DM 88,— 
Fax 0 50 66/998 99 
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Effiziente 
Speicher- 
verwaltungen 


Haben Sie schon einmal versucht, ungefähr 
191158 Objekte gleicher Größe vom Betriebs- 
system anzufordern? Nein? Macht nichts. Ir- 
gendwann werden $ie auch einmal dazu kom- 
men. Aber wenn das doch der Fall war, sollten 
Sie diesen Artikel nicht nur überfliegen. Die- 
ses Problem tritt meist nur bei Programmen 
auf, die mit dynamischen Datenstrukturen 
„rechnen“ müssen. 


peicherverwaltung ist ein Problem, daß man meistdem 
S Betriebssystem oder der Programmiersprachen-Library 

überläßt. Diese gehen damit recht stiefmütterlich um. 
Aus diversen Artikeln u.a. in dieser Zeitschrift [1, 2] und 
Büchern wissen wir alle von der mangelhaften Speicherver- 
waltung mittels der sogenannten Memory-Deskriptoren (MDs) 
des GEMDOS. Also griffen die Hochsprachen-Compiler zu 
unterstützenden Maßnahmen in Formeigenener, vorgeschal- 
teter Routinen, die die Anzahl der malloc-Aufrufe an das 
Betriebssystem reduzieren. Aber auch das ist nicht immer 
der Weisheit letzter Schluß. 


Das Problem 


Es wird eine große Zahl von gleich großen Speicherbereichen 
benötigt. Die genaue Zahl läßt sich nicht im voraus bestim- 
men. Sie ist von Programmaufruf zu Programmaufruf ver- 
schieden. Ebenso ist die Größe dieser Bereiche erst zur 
Laufzeit feststellbar. Geschwindigkeit hat das Primat über 
Speicherverbrauch (auch ein 1040er hat eine Menge Spei- 
cher). Dieses Problem tritt dann auf, wenn man dynamische 
Datenstrukturen aufbaut, deren Speicherbereiche über eine 
Funktion vom System (hier und im folgenden ist damit sowohl 
die GEMDOS-Speicherverwaltung als auch die in der Pro- 
grammiersprache integrierte gemeint) angefordert werden 
sollen. In Pascal wird dafür die Funktion new(‘record) ver- 
wendet. 
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Die Lösung... 


... Ist eigentlich recht einfach und wurde z.B. in einfacherer 
Form in [3] benutzt. (Gute Lösungen sind immer einfach.) 
Wenn es auch in der Problembeschreibung so klingt, als ob 
hier der Speicher verschwendet würde, so ist dies, wie wir 
weiter unten sehen werden, nicht der Fall. In der Tat arbeitet 
der Algorithmus speichersparender als andere, wenn nur 
eine genügend große Zahl von Records benötigt wird. 

Im Prinzip besorgen wir uns von der Speicherverwaltung 
[also über malloc()] einen zusammenhängenden Speicherbe- 
reich (Block), der eine gewisse größere Menge unserer benö- 
tigten Strukturen umfaßt. Diese können wir als ein einfaches 
Array verwalten, indem wir bei Bedarf das nächste freie 
Element zur Verfügung stellen. 

Ist der Block voll, wird ein neuer vom System angefordert, 
und die Zuteilung erfolgt nun aus diesem. Die Verwaltung des 
gerade aktuellen Blocks erledigen wir übereine Tabelle. (Eine 
Verkettung als sequentielle Liste durch Zeigeram Anfang des 
Blockes ist leicht zu implementieren.) Wir erhalten also ein 
zweistufiges System, über das uns Speicher zugeteilt wird. 
Das Ziel ist eine möglichst flexible Verwaltung, die nicht 
durch irgendwelche Konstanten beschränkt wird. Damit ist 
sowohl eine Anpassung an die eigenen Programme als auch 
an die dynamischen Anforderungen innerhalb eines Pro- 
grammlaufes möglich. Insbesondere ist die Größe des benö- 
tigten Records flexibel. Gleiches gilt für Art und Umfang 
verschieden großer Datenstrukturen. 


Als Informationen werden folglich benötigt: 

- die Adresse der Tabelle der Blöcke memtab. In ihr werden 
die Blöcke in die Verwaltung eingeklinkt. 

- der Index innerhalb der Tabelle der Blöcke memtabidx. 
Dieser zeigt auf den Block, aus dem die Zuteilung erfolgt. 

-die maximale Anzahl der Blöcke memtabsize, die über 
malloc vom System geordert werden sollen. Diese Begren- 
zung ist eigentlich nicht nötig, aber sie ermöglicht eine 
rechtzeitige garbage-collection (Müllbeseitigung), wenn Ob- 
jekte auch wieder freigegeben werden müssen. Sonst wird 





Aufruf: searchmembcntri(size) 

Funktion: suchtnach Speicherverwaltungsstruktur 
oder legt diese neu an 

Parameter: size: Größe des benötigten Speichers 

Rückgabewert: Adresse auf Speicherverwaltungs- 
struktur 

Aufruf: freshmem({mem) 

Funktion: reserviert Speicher 

Parameter: mem: Adresse auf Speicherverwaltungs- 
struktur [Rückgabewert von search- 
mementrl()] 

Rückgabewert: Zeiger auf Speicherblock; bei Fehler 
NULL 

Aufruf: freememisize, ptr) 

Funktion: Speicherblock freigeben 

Parameter: size:Größe des Speicherblocks 
ptr:Zeiger auf Speicherblock 


Rückgabewert: keiner 




















PROGRAMMIERTIPS 


solange Speicher vom System angefordert, bis die Library- 
Routine abwinkt. Das ist insofern fatal, als es auch andere 
Routinen gibt, die Speicher benötigen. Auch diese könnten 
dann nicht mehr bedient werden. Wird vorher abgebro- 
chen, haben sie jedoch noch eine Chance. 

- die Adresse des augenblicklichen Blockes memblockptr. 
Dadurch wird die Zugriffsgeschwindigkeit auf einen neuen 
Record beschleunigt. 

- der dazugehörige aktuelle Index memblockidx innerhalb 
des aktuellen Blockes. 

- diverse statistische Informationen, wie die Anzahl der be- 
legten Elemente aller Blöcke memstatuentries, die Zahl der 
noch freien Elemente memstatfentries nach einer garbage- 
collection, und die Zahl der zur Verfügung stehenden Ele- 
mente memstatentries. Letztere unterscheiden sich erst 
dann von memstatuentries, wenn das System keinen wei- 
teren Speicher zur Verfügung stellt und man den Müll 
(garbage) einsammeln und verwenden muß. 

-da wir verschiedene solcher Speicherorganisationen für 
unterschiedlich große Datenstrukturen verwalten wollen, 
verketten wir die Kontrollinformationen miteinander und 
benötigen deshalb einen Zeiger auf das nächste Spei- 
cherverwaltungselement memnext. 


Der Algorithmus 


Wenn nun ein Programm eine bestimmte Datenstruktur be- 
nötigt, die sehr häufig vorkommt, ruft es das Unterprogramm 
freshmem!() auf. Es erwartet die Adresse einer oben beschrie- 
benen Speicherverwaltungsstruktur. Um diese zu erhalten, 
wird in einer verketteten Liste mit Hilfe der Funktion search- 
memecntrl() nach einer passenden Struktur gesucht. Wer will, 
kann bei bekannten Record-Größen diese auch fest „ver- 
drahten“ und schon passende Variablen anlegen. 
searchmementri() durchsucht die Liste der Speicherverwal- 
tungsblöcke sequentiellnach dem zugehörigen Verwaltung- 
sblock. (Das Suchverfahren bricht ab, wenn size >= mem 
->memsize ist.) Wird keine solche gefunden, d.h. keine 


Verwaltungsstruktur verwaltet Speicherbereiche der Größe 
sizeof(struct myrec), wird eine solche eingerichtet. 

Diese Aufgabe erledigt newmementri(). Die Routine ermit- 
telt aufgrund der Größe der gewünschten Datenstruktur die 
Blockgröße als ein ganzzahliges Vielfaches in der Nähe von 
„willkürlich“ 8 kB. Weiterhin werden die Verwaltungsinfor- 
mationen in der Speicherstruktur auf Anfangswerte gesetzt. 
Nachdem searchmemocntri() dieneue Speicherstruktur einge- 
kettet hat, wird diese zurückgegeben. 

Zurück zu freshmem!(). Diese Funktion soll ein Objekt einer 
Datenstruktur liefern. Dazu haben wir ihr ja die zugehörige 
Speicherverwaltung übergeben. Das Unterprogramm unter- 
scheidet zwei Phasen: 


- Phase 1: Es gibt noch Speicher vom System, oder die 
maximale Anzahl von Blöcken ist noch nicht erreicht. 

- Phase 2: Es gibt keinen Speicher vom System mehr, oder 
die maximale Anzahl der vom Programm zu benutzenden 
Blöcke (falls es eine solche Grenze geben soll) ist erreicht. 
Dann werden nur noch Records aus einer verketteten Liste 
zur Verfügung gestellt. Diese muß dann aus den nichtmehr 
verwertbaren Elementen aufgebaut sein. 


freshmem() überprüft zuerst, ob wir uns noch in Phase 1 
befinden. Das ist der Fall, wenn das System noch Speicher- 
platz für die Blöcke zur Verfügung stellen konnte. Anfangs ist 
dies (fast) immer so. Dann wird überprüft, ob es noch freie 
Records innerhalb eines Blockes gibt (mem->memblock- 
idx++ <mem->memblocksize). Ist dies nicht der Fall, wirdein 
neuer Block vom System angefordert und an der Stellemem 
->memtabidkx in der Tabellemem->memtab eingetragen. Der 
Aufruf von memset() löscht den Block. Zurückgeliefert wird 
nun der erste Record innerhalb dieses Blockes. 

Es kann aber passieren, daß entweder keine neuen Blöcke 
mehr angefordert werden dürfen (dies ist bei entsprechender 
Dimensionierung dermemtab mittels des Makros CELLTAB- 
SIZE ziemlich unwahrscheinlich), oder daß es keinen freien 


Speicherplatz mehr dafür gibt. In beiden Fällen wechseln wir 











ATARI ST / PD zum PD-Preis! 


Jetzt auch MS-DOS! 
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Mit der Software S5SPG können Sie 
STEPS- Programme erstellen und auf 
dem ST testen. 

SSPG bietet Ihnen einen einzigartigen 
dynamischen Anlagensimulator 
(ASM). 

S5PG läßt sich ON-LINE an jeder SPS 
der SIMATIC S5 U-Serie betreiben. 
S5PG eignet sich sowohl zum 
Programmieren alsauch zum Lernen. 
SSPG ist das leistungsfähigste SPS- 
Programm für Ihren ST. Seit 1988 über 
1000 Systeme im täglichen Einsatz. 
Investieren auch Sie DM 398,-- in Ihre 
persönliche Zukunft. 


Karstein Datentechnik 
8451 Birgland, Aicha 10 
Tel 09186 1028 Fax 09186 704 








ST-BOOKKEEPER 
(Finanzbuchhaltung. DM 248.-) 


ST-AUFTRAG & ST-BOOKKEEPER 
im Business-Paket 


ST-V-SCHECK 
(Einreichen und Verwalten von Verrechnungsschecks, DM 119.-) 


ST-ÜBERWEISUNGSDRUCK 
‚von Überweisungsträgern, Lastschriien, Schecks usw., DM 45.-) 


DATENBANKANWENDUNGEN 

!erbg benutzbare Datenbanken für Admens ST, DM &2.-) 
ST-SCHREIBMASCHINE 
(Schreibmaschinensimulation, DM 59.-) 


(Bedrucken 


Neun 


ST-ETIKETT 
(Eiksttandruckprogramm mit Seriennummerngeneraiot, DM 50.) 
ST-TRAINER MATHEMATIK 
(Lern und Trainingsprogramm für Schüler, DM 59.) 
AS-HAUSHALT 
(Haushahisbuchführung, DM 59.-) 
ST-FIRMENBUCH 
(Buchführung für Gewerbetreibende, DM 89.-) 





Gesamtkatalog kostenlos! Versand nur gegen Vorauskasse (Y- Scheck, 
keine zusätzlichen Versandkosten) oder per Nachnahme (DM 650 
Versandkosten). isketten nur gegen Vorauskasse. 











AS-DATENTECHNIK 
Mainzer Str. 69 * D-6096 RAUNHEIM 
77 * FaxiBix: 0614272 33 79 

















Katalog-Disk 2,- DM / Bitte Computer angeben! 
Alle großen Serien lieferbar! Abo nur 1,70 DmI 


Jedes Paket (15 Disks) nur 35,- DM: 
Paket 1: 200 Signum-Fonts für alle Drucker (s/w) 
Paket 2: Alles Wichtige für Einsteiger (s/w) 

Paket 3: Spiele für den S/W-Monitor 

Paket 4: Spiele für den Faromonitor 

Paket 5: Clip-Art-Sammlung (s/w) 

Paket 6: Die besten Anwenderprogramme (s/w) 
Paket 7: Ausgewählte Lernprogramme 

Paket 8: Erotik-Paket (Altersnachweis!) 




















Paket 9: Paket mit 30 Disketten, voll mit 
Signum-Fonts für alle Drucker - 400 Zeichen- 
sätze aus England nur 69,- DM 

Preiswerte Farbbänder: zB. Star LC-10 nur 7,95 DM 
Preiswerte Disketten: z.B. 50 3,5" DD (TDK-Buk) nur 49,- DM zzgl 
Porto/Verpackung - PD-Versandkosten: Vorkasse: 6,- DM 

NN: 7,- DM zzgl. NN-Gebühr. Ausland: nur Vorkasse 12,- DM 








Hintermeier - Software-Versand 
A.d.Pfingstweide 3 - Postfach 1113 
DW-3551 Lahntal-Sarnau 
Telefon 06423/6413 (pers. 18-19 Uhr) 


24-h-Bestellannahme / Kein Ladenverkauf! 
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zur Phase 2. Von nun an können wir nur noch Datenstruk- 
turen zur Verfügung stellen, die von unserem Anwen- 
dungsprogramm freiwillig zurückgegeben worden sind. Dies 
tat es (hoffentlich) mittels des Unterprogramms freemem(). 
Es kann auch eine sogenannte garbage-collection collect- 
garb() aufgerufen werden, die das Aufsammeln des entspre- 
chenden Speichermülls besorgt. Nun wird immer nur von der 
Freispeicherliste das 1. Element zurückgegeben. Hier nun 
der Vollständigkeit halber eine Einschränkung des Verfah- 
rens (die eigentlich keine ist). Die minimale Speichergröße für 
Records ist die Größe eines Zeigers, also im allgemeinen 4 
Bytes. 

Eine einfache Modifikation des Unterprogramms fresh- 
mem() erlaubt die sofortige Nutzung zurückgegebener Re- 
cords. Aus der Phase 2 kehren wir niemals in die Phase 1 
zurück. 


Was bringt’s 


Diese Frage hat zwei Seiten. Zum einen: 


- Wie steht es mit dem Speicherverbrauch? Die Verwaltung 
des Systems muß dem Verbrauch der Blockverwaltung 
gegenübergestellt werden. Aus [1] wissen wir, daß die 
benötigten Records in TURBO-C mittels 8 Bytes verkettet 
werden. Für „n“ solcher Datenstrukturen benötigen wir also 
„8n“ Bytes. Hinzu kommen, und das werden wir vernach- 
lässigen, 16 Bytes für initiale Verwaltungseinträge je vom 
System benötigten Block. 

Das hier vorgestellte System benötigt eine Tabelle der zu 

verwaltendenen Blöcke, also CELLTABSIZE’sizeof(long * *) 

== 4*CELLTABSIZE Bytes, sowie eine Verwaltungsstruktur 

[sizeof(struct memcntrl) == 46 Bytes] und zusätzlich 

sizeof(sysmem) == 4 Bytes. Weiterhin sind die vom System 

benötigten Verwaltungs-Bytes zu berechnen. Diese schät- 
zen wir mitjeweils 8 Bytesje Block nach unten ab. Wann lohnt 
sich also diese Verwaltung? Genau dann, wenn 


8*n > A*CELLTABISZE + 46 + 4 + 8*(trunc (n/anzblk)+1) 
mit 
anzblk = max (BLOCKSIZE / sizeof(struct myrecord),1) 
:=> mit 
sizeof(struct myrecord) < BLOCKSIZE 
8*(n - trunc((n * sizeof (struct myrecorä))/ 
BLOCKSIZE)) >4* CELLTABISZE + 50 + 8 
CELLTABSIZE kann aufgrund der normalerweise maximalen 
Ausbaustufe von 4MB für den Atari maximal 4MB/8kB =512 
Bytes sein. 
=> 
n - trune((n * sizeof (struct myrecord))/ 


BLOCKSIZE) > 256 + 50/8 + 1 


macht ungefähr 


108 SWSonderhett 4/1992 








struct nencntr] *sysnen 



































long nentabsize; 
long nenblockidx; 
long nenblocksize; 
int nmensize; 

long #nenfreelist; 
long #nenblockptr; 
struct mencntrl *mennext; 







































































Komplette Speicherverwaltung 





Größe der >n 
Datenbereiche 

4-22 263 

24-54 264 

56-84 265 

86-... 256 


Tabelle 1 für BLOCKSIZE = 8kB ohne Berücksichtigung 
des zusätzlichen Programmcodes 


Größe der >n 
Datenbereiche 

4-10 263 

12-26 264 

28-42 265 

44-56 256 

Sb: 267 


Tabelle 2 für BLOCKSIZE = 4kB ohne Berücksichtigung des 
zusätzlichen Programmcodes 


Größe der >n 
Datenbereiche 

4-18 327 

20-42 328 

44-68 329 

70-... 330 


Tabelle 3 für BLOCKSIZE = 8kB mit Berücksichtigung des 
zusätzlichen Programmcodes 








n - n * sizeof(struct myrecord)/BLOCKSIZE > 256 
+ 50/8 + 1 = 263.25 


n*(1 - sizeof(struct myrecord)/BLOCKSIZE) > 263.25 
n > 263.25 / (1 - sizeof (struct myrecord)/ BLOCKSIZE) 


In den Tabellen 1 und 2 kann man für verschiedene Größen 
eigener Datenstrukturen sehen, ab wann sich diese Spei- 
cherverwaltung lohnt, differenziert nach Größe der jeweiligen 
Blöcke. Wie man sieht, lohnt es sich bereits schon nach 
wenigen Datensätzen gleicher Größe. 

Eigentlich müssen wir bei unseren Überlegungen auch 
noch den Speicherverbrauch der programmierten Routinen 
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berücksichtigen. Diese schlagen unter TURBO-C mit ca.512 
Bytes zu Buche. Daraus ergibt sich ein Korrekturfaktor von 
512/8=64 für dierechte Seite der Ungleichung. (Daten hierzu 
finden sich in Tabelle 3.) 


- Ein anderer Aspekt ist die Geschwindigkeit des ablaufen- 
den Programms. Diese hat sich in meinen Fall mehr als 
verdoppelt. Im Durchschnitt besteht die Allokation eines 
neuen Records aus dem zumeist nicht benötigten Zugriff 
auf die entsprechende Verwaltungsstruktur und einem Ar- 
ray-Zugriff. 

Die Adresse wird einfach durch Shift-Operationen und einfa- 

che Addition desIndexes ermittelt. Die Zeit für einen Unterpro- 

grammaufruf und die Abfrage der Phase kommen hinzu. 

Insgesamt ist dieses Verfahren wesentlich schneller als das 

Durchsuchen einer Freispeicherliste mittels eines womöglich 

dem Problem nicht adäquaten Verfahrens (First/Best-Fit ...). 

Hinzu kommt, daß bestimmte Verwaltungsalgorithmen die 

freigegebenen Speicher recht stiefmütterlich behandeln. 


Abschlußbemerkung 


Wie man wieder mal sieht, kommt es bei der effizienten 
Programmierung von Problemen weniger auf eine hoch- 


ASS 6502 DM 9.- 
Symbolischer 2-Pass-Cross-Assembler für den 6502 


Strukto DM 79.- 


Zeichnen von chemischen Strukturformeln 


SLM-Fontdisketten DM 35.- 
2 Disks mit insgesamt ca. 40 Fonts für Atari-Laserdrucker 


TOS-Construction-Set DM 60.- 


Veränderung der Icons und Zeichensätze des TOS 


PCB Edit DM 19.- 


Platinenlayoutprogramm, auch für Bestückungspläne und 
Schaltpläne. Ausführliches Produktinfo anfordern! 


Scope ST DM 439.- 
Universelles Meßgerät. Oszillograph, Speicheroszilloskop, 
Voltmeter, Sampler, Funktionsgenerator. 

Datenblatt anfordern! 


Meß-Kit ab DM 349.- 


Meßwertaufnahme, -auswertung und Kurvenausdruck. 
Verschiedene Meßgeräte mit unterschiedlicher Ausstattung, 
bis zu 8 Kanäle, 4.5 Stellen (16 Bit). 

Bitte fordern Sie ausführliche Infos an! 












Rosi 


Datentechnik 









Reiner Rosin 
Peter-Spahn-Sir. 4 
6227 Oestrich-Winkel 
Tel./Fax 06723 4978 








Nicht länger warten 
Mit Case/SA starten 


Spec: PI 


Strukturierte Analyse nach Yourdon/deMarco: Datenflußdiagramme, 
Spezifikationen. Data Dictionary und integrierte Prüfung des Systemmodells 


Case/SA V2.0 für IBM-PC 
Case/SA V2.0 für ATARI-ST/TT DM 449.- 
DemoVersion 


optimierte Befehlsfolge und „geniale“ Registerallokation oder 
eingestreuten ASM-Anweisungen als auf einen intelligente- 
ren Algorithmus an. Die hier vorgestellten Routinen sollten 
leicht in Programme eingebunden werden können. Anwen- 
derschnittstellen sind nur die Unterprogramme freshmem]), 
searchmemcentri() und freemem(). Der Programmcode hält 
sich in Grenzen und ist zudem noch portabel. Für alle 
Programme, die mit einer größeren Anzahl von gleichen 
Datenstrukturen kämpfen, ist dies im Vergleich zu den Sy- 
stemroutinen eine bessere Lösung. Wer allerdings extrem 
optimieren möchte, kann dieses Verfahren mit dem in [1] 
vorgestellten kombinieren (oder sogar mittels Assembler- 
Anweisungen implementieren). 


Literatur: 

[1] Hans-Jürgen Richstein, 

Memory Manager - Leistungsfähige Speicherverwaltung in Turbo-C, 
ST-Computer 1990, Nr. 11 

[2] A. Esser: TOS Intern, 

ST-Computer Sonderheft Nr. 2 

[3] Sharam Hekmatpour, 

Lisp - A portable implementation. Prentice Hall 1989 


Context Diagram 
































Data Dictionas 

ss] 

FB = Baal 
Bnaız 


+Bpard 
Boat = 

















SOFTWARETECHNIK 
Dipl.-Ing. U.Böhnke 
Tengstr. 43 

D-8000 München 40 
Tel: 089/2724723 
Fax: 089/2724751 


DM 549,- 


DM 49,- 
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Neue 


form _do-Routine 


Die form_do-Routine des AES ist beim Arbei- 
ten mit Dialogboxen ein praktisches Hilfsmit- 
tel, um die Kommunikation des ATARI ST mit 
dem Benutzer zu erleichtern. form_do() über- 
nimmt die komplette Verwaltung der Objekte 
innerhalb einer Dialogbox. Was aber, wenn 
man während des Dialogs zusätzliche Aktio- 
nen (z.B. eine eigene Tastaturabfrage) durch- 
führen will? 


| reSeimetlutz Preßler | 


der wenn man das Aussehen von “Standardobjekten” 
0 verändern will? Hier kommt man mit der eingebauten 

form_do-Routine nicht weiter, sondern muß sich eine 
eigene Eingabe programmieren. 

Bei der Programmierung von Dialogen nimmt uns das GEM 
mit seiner form_do-Routine einen Großteil der Arbeit ab. Ist 
die Dialogbox einmal per Resource Construction Set erstellt, 
wird nach dem Zeichnen dieses Objekts [mit Hilfe von 
objc_draw()] einfach die form_do-Routine des AES aufgeru- 
fen, und der Dialog mit dem Benutzer läuft automatisch ab. 
Das Hauptprogramm erhält erst wieder die Kontrolle, wenn 
die Dialogbox über ein EXIT- oder TOUCHEXIT-Objekt ver- 
lassen worden ist. 

Vielleicht haben Sie sich aber schon die Frage gestellt, wie 
es manche Programme (z.B. das DISKUS-Diskutility oderder 
TEMPUS-Text-Editor) realisieren, die Buttons innerhalb ei- 
ner Dialogbox auch über die Tastatur zu erreichen. Dies ist 
nur über eine neue Eingaberoutine möglich, die die vorhan- 
dene form_do-Routine ersetzt und neue Funktionen ermög- 
licht. 

Was muß eine solche Eingaberoutine leisten? Zunächst 
müssen Eingaben oder Änderungen, die über die Tastatur 
oder die Maus hervorgerufen werden, auf dem Bildschirm 
dargestellt werden. Wird also eine Taste gedrückt, muß das 
der Taste entsprechende alphanumerische Zeichen in das 
aktuelle Eingabefeld der Dialogbox übertragen werden. An- 
schließend muß der Eingabe-Cursor auf die nächste Zei- 
chenposition gesetzt werden. Handelt es sich bei der ge- 
drückten Taste um die Tabulator- oder eine Cursor-Taste, 
muß ein Wechsel der Eingabeposition oder des -feldes 
erfolgen. Weiterhin muß sich der Programmierer darum küm- 
mern, daß der Cursor innerhalb von Eingabefeldern an der 
richtigen Stelle dargestellt wird. 
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__ DIALOG.PRE 





ee Fe 
(Testdialog für neue forn-do-Routine ) 


Eingabefeld 1: NAXON--... 
Eingabefeld 2: --— 


ETITITTECTEE (Radiobutton 2 





IR Iee] 





Schließlich müssen auch Mausaktionen überwacht wer- 
den. Wird ein EXIT- oder TOUCHEXIT-Button angeklickt, 
muß der Dialog beendet werden. Handelt es sich um einen 
Radio-Button, muß dies insofern berücksichtigt werden, als 
nicht nur der Status des angeklickten Buttons geändert 
werden muß, sondern auch andere Radio-Buttons einen 
neuen Objektstatus erhalten müssen. 

Sie sehen, es gibt viel zu beachten. Glücklicherweise be- 
sitzt das AES genügend Unterroutinen, um bei der Verwen- 
dung einereigenen Dialogroutine die Überwachungderoben 
aufgeführten Eingaben zu erleichtern. Insbesondere spreche 
ich damit die Funktionen form_keyba(), form_button() und 
objc_edit() an. In Verbindung mit diesen AES-Routinen läßt 
sich eine Eingaberoutine formulieren, die einige neue Mög- 
lichkeiten zur Verwaltung von Dialogen bietet und vom äuße- 
rem Erscheinungsbild her wie eine “normale” Dialogbox 
wirkt. 

Damit die folgenden Ausführungen nicht graue Theorie 
bleiben, soll anhand des Beispielprogamms DIALOG aufge- 
zeigt werden, wie die Programmierungeinereigenen form_do- 
Routine vonstatten gehen kann. DIALOG stellt eine Dialog- 
box auf dem Bildschirm dar, die aus zwei Eingabefeldern, 
zwei Radio-Buttons sowie einem “OK”- und einem “AB- 
BRUCH"”-Button besteht. Die Buttons können wie üblich 
über die Maus bedient werden, und auch sonst bestehen auf 
den ersten Blick keine Unterschiede zu anderen Dialogbo- 
xen. 

Wie sieht es auf den zweiten Blick aus? Nun, Radio-Button 
1 kann nicht nur über die Maus, sondern auch über die 
Tastenkombination [ALTERNATE] [1] betätigt werden, Ra- 
dio-Button 2 ist über [ALTERNATEI][2] ansprechbar. Darüber 
hinaus kann der “ABBRUCH”-Button über die [Undo]-Taste 
erreicht werden. 

Das ausführlich kommentierte Assembler-Listing zu DIA- 
LOG.PRG möchte ich nun als Grundlage nehmen, um die 
Programmierung einer eigenen Dialogroutine zu erläutern. 
Wie bereits erwähnt, bilden die AES-Routinen form_keyba() 
und form_button() das Kernstück des Programms. form_- 


FEST - UND WECHSELPLATTEN 


[A:\ MD 88] 


0] E MB Wechselplatte Syquest m 
24 ms, 800 Kb/s 


NEU 83 MB 


WECHSELPLATTE FÜR ATARI ST, 
ATARI MEGA STE, ATARI TT, APPLE, 
NEXT, IBM, KOMPLETT INCL. KABEL 
UND MEDIUM, AUCH IM MEGA-ST 
GEHÄUSE 


AB 1598,- DM 


TEST ST-COMPUTER 9/91 
“IN ALLEN ANSPRÜCHEN 
PROFESSIONELL” 








KOMBISTATIONEN: 

88 MB WECHSEL + FESTPLATTE 
MHDS-88-105 2498,— 
WECHSELPL. + QUANTUM 105 MB 
MHDS-88-210 3198,— 
WECHSELPL. + IMPRIMIS 210MB 
MHDS-88-545 4698,— 
WECHSELPL. MIT CONNER 3,5" 

12 MS, 1300 KB/S SUPER! 


KOMPL. ANSCHLUSSFERTIG INCL. KABELN UND 
MEDIUM, AUCH MIT 44 MB WECHSELPLATTE 
LIEFERBAR! mit ICO-Hostadapter 


FESTPLATTEN: 

MHD52: 52 MBQUANTUM, 17MS AB 898,— 
MHD 105: 105MB QUANTUM, 17 MS AB 1198,— 
64 KB CACHE, 1200 KB/S, SUPERLEISE 


MHD-50: 52 MB, Seagate 845,— 


WEITERE KOMBISTATIONEN: MHD-80: 84 MB,SEAGATE SEEN 998,— 
44. MP SYQUEST-WECHSELPLATTE + FESTPLATTE MHD-87: 83 MB, STIO6N,2 .1048,— 
MHES-44-52 ' MHD-210: 210 MB, ST 123 1798,— 
sale MHD-545: 545 MB, CONNER, 12MS 3498,— 
44MB + QUANTUM 105 MB,1200KBIS, 17ms B 3 MHD 240:(Quantum LPS 240 MB, 12 MS) 1998, — 
MHDS-44-80 f WECHSELPLATTEN: 


44 MB + SEAGATE ST Z6N, 84 MB,2Ami MHDS-44: SYQUEST 44MB28MS AB 1145,— 
MHDS-44-81 F INCL MEDIUM 

44 MB + SEAGATE ST 1096N, 83 MB,22ms SERÄTE KOMPLETT ANSCHL.FERTIG AUCH IM KLEINEN TT- 

MHDS —44— 210 h FESTPLATTENGEHÄUSE LIEFERBAR 

44 MB + IMPRIMIS ST 1239N, 210MB.löms SCANNER 

MHDS — 44 — 54Btauch im 35"- Format!) k Trade iT SCAN 256 w Bee 

44 MB + CONNER (GANZ NEU),545M! rade ı V-SOFTWARE SONDERPREIS 
WIR LIEFERN AUCHFESTPLATTEN BIS 2 GIGABYTE! Trade iT COLOR Can 300: A4-SCANNER MIT GAMMA-KOR 
Mit ICD Advantage/(Plus) Hostadapter, DMA in/out gepuffert, SCSI-Bus herausgeführt, REKTUR, 16.7 6 GS, 300DPI aA 
SCSI-Adresse einstellbar (0—7), Max. 256 Partitionen möglich, Läuft unter allen ATARI- HP-DES PATRONE aA 


Betriebssystemen von TOS 1.0 bis 3.06, Auch mit UNIX, MS-DOS, ‚Spectre, 0S—9 uvm. WEITERES LIEFERPROGRAMM: 


Vollkommen ATARI AHDI 4,xx-kompatibel, Autoboot von allen Partitionen — Autopark Y- STATION 144 MB TEAC 235-PS2 KOMPL. 198, 
ATARI TT/ST/Mega ST a.A. 25”, TEAC FD 55GFR 249 — 


ATARI LASERDRUCKER SLM 605 2098,— MB MEDIUM EXTRA 2 = 





Nur mit den bewährten ICD-Hostadaptern haben Wir haben noch viel mehr: 
Sie 1. Qualität. Vertrauen Sie auf diese Technik 


Kelirrtümer vorbehalten en Kol Weiteres auf Anfrage 12a 


M. Fischer Computer Systeme Tel. 061 64 - 4601 
Goethestr. 7 6101 Fr. Crumbach Fax061 64 - 3748 
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keybdf) ermöglicht es, in einer Dialogbox Tastatureingaben 
zu simulieren, mit form_button() kann die Betätigung eines 
Mausknopfes simuliert werden. Damit man die Möglichkeit 
hat, während des eigentlichen Dialogs zusätzliche Aktionen 
vorzunehmen, geschieht die Abfrage von Tastatur und Maus 
nun nicht mehr über die eingebaute form_do-Routine des 
AES, die ja Manipulationen während des Dialogs nicht zuläßt, 
sondern über dieevnt_multi-Routine. Allgemein können über 
evnt_multi() diverse Benutzeraktionen überwacht werden. 
Um zu spezifizieren, worauf evnt_ multi() konkret achten soll, 
wird ein Parameterwort übergeben, in dem je nach zu über- 
wachender Aktion entsprechende Bits gesetzt sind. Nach 
diesem AES-Aufruf überwacht GEM für unsso lange Tastatur 
und Maus, bis eine Aktion (Tastendruck oder Betätigung der 
Maustaste) seitens des Benutzers erfolgt. Erst dann wird die 
Programmkontrolle wieder an das Hauptprogramm zurück- 
gegeben. Ist dies geschehen, so finden sich in einem eigens 
für den evnt_ multi-Aufruf errichteten Array (in unserem Fall 
ev_buff) Angaben über die Art der Aktion. Wie bereits beim 
Aufruf von evnt_multi() werden diese Daten wieder durch 
einzelne Bits repräsentiert. 

DIALOG.PRG verzweigt nun, je nachdem, um welche Akti- 
onessich gehandelt hat, in eine Routine zur Behandlung von 
Mausaktionen oder kümmert sich um die Taste, die vom 
Anwender gedrückt wurde. Beschäftigen wir uns zunächst 
mit dem Fall, daß evnt_multi() einen Tastendruck gemeldet 
hat. ASCII- und Scancode der gedrückten Taste werden uns 
im ev_buff-Array mitgeteilt. Liefert evnt_multi() einen gültigen 
ASCII-Code zurück, handelt es sich um eine “normale” 
alphanumerische Eingabe, und das Zeichen kann direkt in 
die Dialogbox geschrieben werden. Ist der ASCII-Code je- 
doch Null, liegt also nur der Scancode der betätigten Taste 
vor, geht es nun darum, festzustellen, ob ein Button existiert, 
der durch diese Taste bedient werden kann. 

Um Buttons über die Tastatur bedienen zu können, werden 
bei DIALOG.PRG Tastenkombinationen zusammen mit der 
[ALTERNATE]-Taste verwendet, da in diesem Fall von 
evnt_multi() nur der Scancode der Taste, jedoch kein ASCII- 
Code zurückgeliefert wird. Natürlich muß man an geeigneter 
Stelle eine Information unterbringen, welcher Button durch 
welche Taste bedient werden kann. Es ist sehr praktisch, 
diese Zusatzinformation innnerhalb der Objektdaten der Dia- 
logbox unterzubringen. Wie ein Objekt organisiert ist, läßt 
sich in Tabelle 1 sehen [1]. Im Wort für den Objekttyp ist nur 
das Low-Byte belegt. Somit steht das High-Byte für eigene 
Anwendungen zur Verfügung. DIALOG.PRG macht sich dies 
zunutze, indem es bei Buttons, die über die Tastatur bedient 
werden können, im High-Byte des Objekttyps den Scancode 
der Taste erwartet, durch die der betroffene Button ange- 
sprochen werden kann. ) Das Programm durchsucht nun 
einfach den gesamten Objektbaum auf ein Objekt, bei dem 
als erweiterter Objekttyp der Scancode der Taste eingetra- 
gen ist, die gedrückt wurde. Findet sich ein solches Objekt 
nicht, wird zum Schleifenanfang zurückgekehrt und der Dia- 
log fortgesetzt. Ist ein Objekt vorhanden, das über die ge- 
drückte Taste angewählt werden kann, wird die Objektnum- 
mer berechnet und über evnt_button() ein Mausklick auf 
dieses Objekt simuliert. Der Effekt eines Tastendrucks in 
Verbindung mit der [ALTERNATE]-Taste ist somit der gleiche 
wie beim Anklicken eines Buttons mit der Maus. 
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Wurde ein alphanumerisches Zeichen (also ein Tasten- 
druck ohne Kombination mit der [ALTERNATE]-Taste) einge- 
geben, wird mit den ASCII- und Scancodes für dieses Zei- 
chen zunächt die form_keybd-Routine aufgerufen, die in der 
Lage ist, diesen Tastendruck für unsere Dialogbox aufzuar- 
beiten. Handelte es sich bei der gedrückten Taste um eine 
Cursor- oder die Tabulatortaste, liefert uns form_keybaf/) die 
Nummer des Eingabefeldes zurück, in der wir nun den Text- 
Cursor positionieren müssen. Zusätzlich bekommen wir in 
diesem Fall eine Null als Rückgabewert, was bedeutet, daß 
keine Taste betätigt wurde, um deren ASCIl-Darstellung wir 
uns kümmern müßten. 

Erhalten wir keine Null zurück, sondern einen positiven 
Wert, so ist das Eingabefeld zwar das gleiche geblieben, aber 
dafür müssen wir an der aktuellen Cursor-Position ein ASCI 
Zeichen eintragen. Dies geschieht mit Hilfe von objc_edit(). 
Diese Funktion erlaubt es, Texteingaben in einem Formular 
vorzunehmen. Nach Aufruf dieser Routine mit dem ASCI 
Code der gedrückten Taste wird das Zeichen in der Dialog 
box dargestellt. Anschließend liefert uns objc_edit() die neue 
Position des Text-Cursors zurück, der ja jetzt um eine Stelle 
nach rechts gerückt ist. 

Falls evnt_multi() abgebrochen wurde, weil ein Maus-But- 
ton betätigt wurde, ist zunächst zu prüfen, ob sich der Maus- 
Cursor überhaupt innerhalb der Dialogbox befindet. Hierzu 
können wir die objc_find-Funktion heranziehen. Die Koordi- 
naten des Mauszeigers, die objc_find() übergeben werden 
müssen, werden uns von evnt_multi($ in ev_buff zur Verfü- 
gung gestellt. Liefert objc_ find() einen Wert größer als Null 
zurück, befand sich der Mauszeiger innerhalb der Dialogbox. 
Andernfalls wird als Fehlersignal ein Glockenton ausgege- 
ben, so wie es auch die “normale” form_do-Routine macht. 

Wurde ein Objekt innerhalb der Dialogbox angeklickt, wird 
AES dieser Umstand mittels form_button() mitgeteilt. Das 
GEM übernimmt den Rest der Arbeit, kümmert sich also z.B. 
darum, ob es sich beim angeklickten Objekt um einen Radio- 
Button handelt. In diesem Fall wird nicht nur der selektierte 
Button invertiert, sondern die restlichen Radio-Buttons wer- 
den deselektiert. Handelte es sich beim selektierten Objekt 
um einen Exit-Button, liefert form_button() einen Wert von 
Null zurück. Ist dies der Fall, wird der Dialog beendet. 

Wurde ein Objekt ausgewählt, das keinen Exit-Status be- 
sitzt, muß zunächst geprüft werden, ob es überhaupt selek- 
tiert werden darf und es sich nicht z.B. um einen String 
handelt. Stellt das angeklickte Objekt ein Eingabefeld dar, 
muß der Text-Cursor auf dieses Feld plaziert werden. Hier 
hilft die objc_ edit-Routine weiter. Zunächst wird der Text- 
Cursor an der alten Stelle entfernt und anschließend an der 
neuen Eingabeposition dargestellt. 

Nun noch zur Darstellung eigener Objekttypen, wie im Fall 
von DIALOG dem String, der von einer abgerundeten Box 
umgeben ist. Will man die Zeichenroutinen des AES umge- 
hen und das Aussehen von Objekten weitgehend selber 
bestimmen, muß man mit benutzerdefinierten Objekten 
(G_USERDEF bzw. G_ PROGDEF) arbeiten. Bei Objekten 
dieser Art zeigt ob_ spec (s.o.) auf eine USER BLK-Struktur 
(s. Tabelle 2). Trifft das AES beim Erstellen eines Dialogs auf 
diesen Objekttyp, wird’die Objektdarstellung nicht vom AES 
übernommen, sondern stattdessen eine Routine aufgerufen, 
deren Adresse vom Programmierer in der obigen Objekt- 
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struktur festgelegt werden kann. DIALOG.PRG nutzt nun 
VDI-Routinen (nur solche dürfen beim Zeichnen eigener 
Objekte aufgerufen werden!) dazu, Text und Rahmen des 
ersten Strings der Dialogbox in einem eigenen Format, also 
mit abgerundeten Ecken, darzustellen. Natürlich sind an 
dieser Stelle die verschiedensten Manipulationen denkbar. 

Eine Frage ist jedoch noch offen geblieben: Wie bringe ich 
im High-Byte des Objekttyps eigene Informationen unter? 
Hier kommt es auf das verwendete Resource Construction 
Set an. Die Methode, den Objekttyp für eigene Daten zu 
nutzen, wird z.B. durch das Resource Construction Set von 
Kuma unterstützt. Hier hat der Anwender die Möglichkeit, für 
jedes Objekt einen sogenannten “erweiterten Objekttyp” 
(extended object type) anzugeben. Die Zahl, die man an 
dieser Stelle einträgt, findet sich im High-Byte des Objekt- 
typs wieder. 

Soweit meine Erläuterungen zur Programmierung einer 
eigenen form_do-Routine. Weitere Informationen können 
dem kommentierten Programm-Listing entnommen werden. 
Der Einbau der vorgestellten Routine in eigene Programme 
gestaltetsichrecht einfach, daim Grunde genommen nur der 
Aufruf der form_do-Routine des AES durch die neue Routine 
ersetzt werden muß. 
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Quantum Festplatten 


typedef struct 
{ 
int ob_next; /* -> nächstes Objekt */ 

int ob_head; /* -> erstes Kind */ 

int ob_tail; /* -> letztes Kind */ 

unsigned int ob_type; /* Objekttyp */ 

unsigned int ob_flags; /* Objektflags */ 

unsigned int ob_state; /* Objektstatus */ 

char *ob_spec; /* Zeiger auf ergänz. Struktur */ 

int ob_x; /* x-Position (rel. zum 
Parent-Objekt) */ 

/* y-Position (rel. zum 
Parent-Objekt) */ 

/* Breite */ 

/* Höhe */ 


int ob_y; 





int ob_width; 
int ob_heigt; 
} OBJECT; 


Tabelle 1: Organisation eines Objektes 


typedef struct 

{ 
int (*ub_code) (); 
long ub_parm; 

}USERBLK; 


/* Zeiger auf die eigene Funktion */ 
/* ein optionaler Parameter */ 





Tabelle 2: Die USERBLK-Struktur 
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Bewegliche 
Dialogboxen 


Wäre es nicht eine tolle Sache, wenn man sich 
seine Dialogboxen so auf dem Bildschirm an- 
ordnen könnte, daß man optimal damit arbei- 
ten kann? Keine Hin- und Herfahrerei mit der 
Maus mehr! Daneben gibt es aber noch ande- 
re, ungeahnte Möglichkeiten. Denn oft wird 
auch ein gerade wichtiger Desktop-Teil von 
einer unvermittelt auftauchenden Dialogbox 
überdeckt, die auch noch unverschämterwei- 
se nach gerade den verdeckten Informationen 
fragt. Dann kann man wieder auf ABBRUCH 
drücken (wenn’s geht), nachsehen, was dar- 
unter steht, dieses auswendig lernen oder 
aufschreiben und daraufhin die ganze Proze- 
dur von neuem starten. 


Matthias Baldauf 


Dialogboxen erstellt werden, die frei auf dem Bild- 

schirm verschiebbar sind oder wahlweise an der 
aktuellen Mausposition erscheinen (aufneuhochdeutsch Pop- 
Up-Menüs genannt). Für Programmierer werden einfach zu 
handhabende Dialogbox-Routinen bereitgestellt, die kom- 
plett den Aufruf, die Darstellung und Verwaltung folgender 
drei Dialogboxtypen übernehmen: 


M it der hier vorgestellten MOVEDIAL-Library können 


- Standard-Dialogboxen: 
diese erscheinen wie gewohnt in der Bildschirmmitte und 
sind nicht verschiebbar. 


- Movedial-Boxen: 
erscheinen beim ersten Aufruf ebenfalls in der Bildschirm- 
mitte, können dann aber vom Anwender beliebig auf dem 
Desktop verschoben („gedragged”) werden. Bei einem er- 
neuten Aufruf erscheinen sie dann wieder an der letzten 
Position. 
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- Pop-Up-Dialogboxen: 
diese tauchen immer dort auf, wo sich gerade der Mauszei- 
ger befindet. 


Die MOVEDIAL-Library kann von interessierten und fachkun- 
digen Anwendern noch erweitert werden, worauf am Ende 
des Artikels noch spezieller eingegangen wird. 


Theorie 


Objekte sind die Grundelemente des ganzen AES-Systems. 
Die Drop-Down-Menüs, Icons, Fenster, Alert-Boxen und 
auch die hier behandelten Dialogboxen bestehen aus nichts 
anderem als Objekten. Diese sind nichts anderes als Da- 
tenstrukturen, die alle grafischen Objekte beschreiben. Alle 
Objekte sind in einem Objektbaum zusammengefaßt. In 
diesem Baumgibtes Nachbarn (ob_next) und Kinder (ob_head 
und ob_tail. Kinder können wieder Kinder haben, diese 
wieder Kinder usw. Nachbarn in dem Objektbaum sind z.B. 
die verschiedenen Dialogboxen eines Programms. Kinder 
innerhalb einer Dialogbox stellen die Texte, Eingabefelder 
und Buttons dar, die selbst wieder Objekte sind. Damit man 
sich das alles ein wenig besser vorstellen kann, soll es an 
einem Beispiel verdeutlicht werden. In Bild 1 ist eine Dialog- 
box zu sehen, in der zwei Kästen mit Buttons enthalten sind 
(abgesehen vom OK-Button). Die beiden Kästen stellen 
Nachbarn (innerhalb der Dialogbox) dar, mit den Auswahl- 





Aufruf: do_dial(dialbox) 
Funktion: führt Standard-Dialog durch 
Parameter: dialbox: Zeiger auf Dialogbaum 


Rückgabewert: angewähltes Objekt 


Aufruf: do_movedial(dialbox, dragger) 

Funktion: führt Dialog mit beweglicher Dialogbox 
durch i 

Parameter: dialbox: Zeiger auf Dialogbaum 


dragger: Nummer des Dragger-Objekts 
Rückgabewert: angewähltes Objekt 


Aufruf: do_popup(dialbox) 

Funktion: führt Pop-Up-Dialog (Box erscheint an 
Mausposition) durch 

Parameter: dialbox: Zeiger auf Dialogbaum 


Rückgabewert: angewähltes Objekt 


Als Ergänzung innerhalb der MOVEDIAL-Library 
enthalten: 


Aufruf: gem_init() 
Funktion: GEM-Initialisierung 
Parameter: keine 







Rückgabewert: VDI-Handle ; 


[Rückgabewert von graf_handle(} 








Aufruf: gem_exit(handle) 
Funktion: GEM-Abmeldung 
Parameter: handle: VDI-handle 


[Rückgabewert von gem _init() 
Rückgabewert: keiner 
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knöpfen als Kinder. Das Schöne an der Sache ist nun, daß 
durch Angabe der Position (ob_x und ob_y) eines der Nach- 
bar-Objekte innerhalb des Vater-Objekts (gemeint ist das 
übergeordnete Objekt, hier der Dialogbox-Rahmen) ver- 
schoben werden kann und gleichzeitig alle Kinder-Objekte 
(hier die Buttons) mit verschoben werden. Das liegt daran, 
daß alle Positionsangaben relative Positionen zum Vater- 
Objekt darstellen. Bei Verschiebung des Vater-Objekts wird 
logischerweise das Kind-Objekt mit verschoben. 

Genau dieser Umstand (die relativen Positionsangaben) 
läßtsich nun zum Verschieben der Dialogbox nutzen. Norma- 
lerweise wird mit einem form_center({)-Aufruf vor dem Zeich- 
nen des Dialogs eine Zentrierung der Dialogbox auf dem 
Desktop vorgenommen. Dieser form_center()-Aufruf be- 
rechnet aus der Desktop- und der Dialogboxgröße ein Koor- 
dinatenpaar (ob_x und ob_y) und trägt dies in die Objekt- 
struktur ein. Unterläßt man das Zentrieren, wird der Objekt- 
baum (also die Dialogbox) an der in der Objektstruktur 
angegebenen Position (ob_x und ob_y) relativ zur Desktop- 
Position ausgegeben. Legt man in jeder Dialogbox einen 
speziellen Drag-Button an (ähnlich der Move-Leiste bei Fen- 
stern, die dem Verschieben dient), kann man nach Druck auf 
diesen Button (linke Maustaste festhalten!) den Dialog ver- 
schieben. Dazu müssen Sie den Drag-Button als EXIT- 
Button deklarieren, worauf nach dessen Anwahl der Dialog 
verlassen wird. Jetztkann die Wegdifferenz, die mit gedrück- 
tem Mausknopf zurückgelegt wurde (die Wegdifferenz der 
Maus wohlgemerkt), erfaßt und zur alten Objektposition 
addiert werden. Dadurch setzen Sie die Dialogbox auf die 
neue gewünschte Position. Da sich dieser Vorgang recht 
kompliziert anhört, soll er durch Bild 2 bildhaft dargestellt 
werden. 

Nach diesen Vorbemerkungen sollen nun die Besonderhei- 
ten der einzelnen Dialogboxarten der MOVEDIAL-Library 
erläutert werden. Wie der Leser sicher schon geargwöhnt 
hat, bauen die einzelnen Dialogboxroutinen auf einem ge- 
meinsamen Unterprogrammstamm auf. Diese Routinen die- 
nen zum Vorbereiten und Zeichnen der Dialogbox sowie zum 
Restaurieren des Bildschirms und benützen ausschließlich 
GEM-Routinen. Das ist der einzig richtige Weg, um 
auflösungsunabhängige Programmezu entwickeln, diedann 
auf jeder vom GEM unterstützten Grafikkarte lauffähig sind. 
Die genannten Routinen sind im einzelnen weiter unten 
beschrieben. 


Standard 


Als erstes soll der Standard-Dialog erwähnt werden. Eigent- 
lich gibt es hierzu nichts mehr Besonderes zu sagen, da 
weiter oben schon alles Wichtige über die hier verwandte 
form_center()-Prozedur geschrieben wurde. Durch diese Rou- 
tine wird die Dialogbox auf dem Desktop mittig zentriert. 


Movedial 


Über die Movedial-Boxen gibt es dagegen einiges mehr zu 
sagen. Nachdem nach obengenanntem Verfahren (Bild 2) 
der Verschiebungsvektor (Differenzwerte in x- und y-Rich- 
tung) ermittelt ist, kann die Dialogbox an der alten Position 
gelöscht und an der neuen wieder ausgegeben werden. 





Interne Routinen der MOVEDIAL-Library [werden v« 
den drei Dialogroutinen do_dial(), do _movedial() Su 
do_popup|() verwendet]: 
Aufruf: vor_dial(dialbox, dialtype) 
Funktion: Vorbereitungen zur 
Dialogboxdarstellung: 
- Position der Box berechnen (mittig 
oder an Mausposition) 
- Koordinaten in Objektstruktur 
eintragen 
- Bildschirmhintergrund mittels 
form_dial() reservieren 
dialbox: Zeiger auf Dialogbaum 
dialtype: Dialogtyp: 
0: Standard-Dialogbox 
1: Movedial-Boxen 
2: Pop-Up-Dialogbox 
Rückgabewert: keiner 





Parameter: 


Aufruf: draw_dial(dialbox, dialtype) 

Funktion: zeichnet Dialogbox mittels objc_draw(); 
vorher unbedingt vor_dial() aufrufen! 

Parameter: dialbox: Zeiger auf Dialogbaum 
dialtype: Dialogtyp [siehe vor_dial()] 

Rückgabewert: keiner 

Aufruf: movedial(dialbox, dialtype) 

Funktion: verschiebt Dialogbox auf dem Desktop 

Parameter: dialbox: Zeiger auf Dialogbaum 
dialtype: Dialogtyp [siehe vor_dial()] 

Rückgabewert: keiner 

Aufruf: nach_dial(dialbox, dialtype) 

Funktion: gibt Hintergrund mittels form_diall) frei 

Parameter: dialbox: Zeiger auf Dialogbaum 


dialtype: Dialogtyp [siehe vor_dial()] 
Rückgabewert: keiner 











Warum aber müssen die Differenzwerte ermittelt werden und 
nicht eine absolute Position? Nun, als Grundlage für dieneue 
Position der Dialogbox wird die aktuelle Mausposition nach 
Loslassen der linken Maustaste genommen. Würde die Dia- 
logbox nun an diese Position gesetzt werden, wäre die linke 
obere Ecke genau unter dem Mauszeiger. Das war aber nicht 
beabsichtigt. Man hatte die Dialogbox ja irgendwo innerhalb 
des Drag-Buttons geschnappt und verschoben; dann soll sie 
gefälligst auch wieder so gezeichnet werden, daß der Drag- 
Button genauso unter der Maus zum Liegen kommt wie vor 
der Verschiebung. Genau das erreicht man durch Addition 
des Verschiebungsvektors auf die alte Dialogboxposition 
(siehe Bild 2). Eine Bereichsüberschreitung, also ein Verlas- 
sen des Desktop-Bereichs beim Verschieben der Dialogbox, 
ist nicht möglich, da die den Verschieberahmen zeichnende 
AES-Betriebssystemroutine graf_dragbox() die Maximalko- 
ordinaten mit übergeben bekommt. 


Pop-Up 


Die Position einer Pop-Up-Dialogbox wird aus der aktuellen 
Mausposition berechnet, d.h. eine solche Box erscheint 
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Bild 1 





Abbruch 










ob_x * diff_x 
ob_y + diff-y 





Bild 2 


immer zentriert um die momentane Mausposition. Dabei gilt 
es natürlich noch die Fälle einer hier möglichen Bereichs- 
Überschreitung abzufangen, denn die Dialogbox soll ja im- 
mer innerhalb des Desktops auftauchen, damit alle Elemente 
auch mit der Maus erreichbar sind. 


MOVEDIAL-Library 


Nach den theoretischen Grundlagen sollen die einzelnen 
Routinen der MOVEDIAL-Library erläutert werden. In der 
Prozedur vor_dial() werden die Vorbereitungen zur Darstel- 
lung der Dialogbox getroffen. Übergeben wird ein Zeiger auf 
den Dialogbaum und der Dialogtyp. Es werden dabei folgen- 
den Typen (dialtype) unterschieden: 


| S 
2 - 
andere - 


Movedial-Boxen 
Pop-Up-Dialogbox 
Standard-Dialogboxen 


In dieser Prozedur [vor_dial()] werden nach den oben bespro- 
chenen Methoden die Zeichenkoordinaten der Dialogbox 
(ob_x und ob_y) relativ zum Desktop ermittelt. Danach kann 
mit dem form_dial()-Aufruf der notwendige Bildschirmhin- 
tergrund reserviert werden. Mit Hilfe der Unterroutine 
draw_dial() wird dann der Dialogbaum auf dem Bildschirm 
ausgegeben. Der Aufruf objc_draw() zeichnet den Objekt- 
baum nur, verwaltet ihn aber nicht. Die Verwaltung wird in 
den weiter unten beschriebenen Routinen do_dial(), 
do_movedial() und do_Pop-Up() vorgenommen. Nachdem 
eine Dialogbox wieder verlassen wurde, muß der Bildschirm- 
hintergrund auch wieder freigegeben werden. Das erfolgt 
durch die Prozedur nach_dial(). 

Als nächstes kann die interessanteste Routine movedial() 
unter die Lupe genommen werden. Hier wird die Dialogbox 
(nur, wenn es sich um eine MOVEDIAL-Box handelt) von der 
alten auf eine vom Benutzer gewünschte neue Position 
verschoben. Nachdem die Maus die Kontrolle übernommen 
hat [wind_update()] und die Form einer Hand (FLAT_HAND) 
bekommen hat, wird die Größe des Desktops ermittelt [mit- 
tels wind_get{]. Jetzt kann die Dialogbox innerhalb der 
Desktop-Grenzen mit der Maus verschoben werden. Die 
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Dialogbox wird dabei als gepunkteter Rahmen dargestellt. 
Zu diesem Zweck stellt das AES schon eine Routine graf_- 
dragbox() zur Verfügung, die alle Bereichsüberschreitungen 
abfängt. Diese Routine behält solange die Kontrolle, wie die 
linke Maustaste gedrückt bleibt. Nach Loslassen dieser 
Taste wird der Dialogbaum an der ursprünglichen Stelle 
gelöscht. Jetzt kann die neue Position berechnet werden. An 
dieser neuen Position werden wieder die Vorbereitungen 
zum Zeichnen der Box getroffen (also Hintergrundspeicher 
reserviert). Hierauf wird die Maus auf den Pfeil (ARROW) 
umgeschaltet und die Mauskontrolle wieder abgegeben 
[wind_update(). 


Standard-Dialog 


Nachdem jetzt alle zur Dialogabwicklung notwendigen Rou- 
tinen vorgestellt wurden, müssen diese nur noch in koordi- 
nierter Reihenfolge aufgerufen werden. Zur Abwicklung ei- 
nes Standard-Dialogs dient die Routine do_dial(), die nach 
Beendigung eines Dialogs den Index des Objekts zurücklie- 
fert, welches zum Verlassen der Dialogbox benutzt wurde. 
Übergeben wird der Zeiger auf die Objektstruktur des ge- 
wünschten Objektbaums. Beim Abarbeiten von do_diall) 
wird als erstes die Routine vor_dial() aufgerufen, die ja be- 
kannterweise (siehe oben) die Vorbereitungen zur Dialog- 
boxdarstellung trifft. Jetzt kann durch draw_dial() der Dialog- 
baum gezeichnet werden. Als dialtype [der zweite Parameter 
der ..._dial()-Aufrufe] muß immer eine Zahl ungleich 1 und 2 
(hier 0) angegeben werden. Nachdem der Dialog jetzt auf 
dem Bildschirm steht, kann das AES die Verwaltung über- 
nehmen [form_do()]. Nach Beendigung des Dialogs wird das 
eventuell selektierte Exit-Objekt wieder deselektiert und der 
Dialog vom Bildschirm entfernt [nach_dial(]. Genauso wie 
die vorgenannte Routine do_dial() ist auch die Prozedur für 
die Pop-Up-Dialoge do_Pop-Up() aufgebaut. Einzig der an- 
dere Dialogtyp (dialtype=2) wird verwandt. Etwas aufwendi- 
gerist.diefür verschiebbare Dialogboxen zuständige Routine 
do_movedial() gestaltet. Nach der bekannten Vorbereitung 
wird solange in einer Schleife (do..while) verblieben, bis ein 
Exit-Objekt ungleich dem Drag-Balken (mit dem Index DRAG- 
GER) zum Verlassen der Dialogbox angeklickt wurde. Inner- 
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halb der Schleife wird der Dialog gezeichnet [draw_dial()] 
und, falls das DRAGGER-Objekt gewählt wurde, durch Auf- 
ruf von move_dial() verschoben. 

Die vorgestellten do_...()-Routinen sind so natürlich nur für 
Boxen mit einem Exit-Button zu gebrauchen, die nicht weiter 
vom Programm verwaltet werden müssen. Das bedeutet, 
daß sie bei Verwendung von programmverwalteten Dialogen 
(z.B. Hoch- und Herunterzählen eines Wertes durch zwei 
Buttons) noch erweitert werden müssen. Eine solche Erwei- 
terung durch einen do{...}while !ende-Block ist im Beispiel- 
programm dargestellt. 


Beispielprogramm 


Im Beispielprogramm soll die Routine do_Pop-Up_menue() 
etwas genauer betrachtet werden. Da dort die Hauptdialog- 
box (ein Pop-Up-Dialog) des Beispielprogramms verwaltet 
wird, werden als erstes die Startadressen aller benutzten 
Dialogboxen (Objektbäume) ermittelt [durch rsrc_gadar|)]. 
Danach wird ein do..while-Konstrukt solange durchlaufen, 
bis der QUIT-Button betätigt wird. Innerhalb der Schleife 
werden als erstes die Vorbereitungen zum Zeichnen des 
Hauptdialogs getroffen. Danach wird dieser gezeichnet. 
Benutzerreaktionen werden wie bekannt durch die AES- 
Routine form_do() abgewickelt, die dann den Index des 
Objekts zurückliefert, das zum Verlassen des Dialogs geführt 
hat. Jetzt kann der Dialog wieder vom Bildschirm entfernt 
werden. Wurde ein Objekt ungleich dem QUIT-Button betä- 
tigt, so werden die entsprechenden Dialogboxen aufgerufen 
(innerhalb des switch()-Konstrukts). Hier können selbstver- 
ständlich auch eigene Unterprogramme aufgerufen werden. 
Würde man aber auf diese Weise das oben angeschnittene 
Problem des in-/dekrementieren eines Wertes über Pfeilbut- 
tons erledigen, wäre dies mehrals unelegant, dajedesmal die 
komplette Box neu gezeichnet werden müßte. 


Erweiterungsmöglichkeiten 


Zum Abschluß möchte ich auch noch die Programmierer 
unter den Lesern zum Verfeinern der vorgestellten Library 
anregen. Unter dem Motto „schöner, größer, besser, mehr“ 
läßt sich noch einiges an den Routinen machen. 

Als erstes ist hierbei an eine bessere Restaurierung des 
Hintergrunds zu denken. Zwar wird nach Beendigung des 
Dialogs die Dialogbox wieder vom Bildschirm entfernt, aber 
leider bleiben Reste in Fenstern zurück. Diese Rückstände 
bleiben solange erhalten, bis die Fensterrestaurierungsroutine 
des Programms aufgerufen werden kann. Ein solcher Aufruf 
erfolgt normalerweise innerhalb einer event_multi()-Proze- 
dur. Wird also eine Dialogbox verlassen, bekommt das AES 
eine REDRAW-Message, was das eigene Programm dazu 
veranlaßt, die entsprechenden Fenster zu restaurieren. Dies 
funktioniert so natürlich nicht bei den MOVEDIAL-Boxen, da 
ja auch nach dem Verschieben innerhalb der do_movedial()- 
Prozedur verblieben wird. Wird also eine MOVEDIAL-Box auf 


dem Schirm verschoben, bleiben innerhalb von Fenstern 
immer Reste zurück. Dem kann man abhelfen (und dies ist 
der erste Erweiterungsvorschlag), wenn man vor dem Zeich- 
nen [durch draw_dial()] den dadurch belegten Bilduntergrund 
retten würde (in einen Pufferspeicher) und ihn nach Aufruf 
von nach_dial() wieder dorthin zurückkopieren würde. Die 
benötigten Ausmaße werden ja auch zum Reservieren des 
Hintergrunds in vor_dial() und nach_dial() ermittelt. Bleibt nur 
noch, auf die Größe des Pufferspeichers hinzuweisen. Die 
benötigte Größe sollte jeweils aus der aktuellen Auflösung 
berechnet werden, da bei späteren Rechnerversionen (z.B. 
TT etc.) die Dialogboxen eventuell größer als die heutige 
Standardauflösung von 640x400 werden könnten (siehe dazu 
Artikel in diesem Heft). 

Eine schöne Sache wäre auch das Verschieben der kom- 
pletten Box statt nur eines Rahmens. Dazu kann die vorge- 
nannte Routine benutzt werden. Nur muß hier auf eine 
Veränderung der Mausposition gewartet und jedesmal der 
Bildschirm restauriert und die Box neu gezeichnet werden. 
Damit das Zeichnen schneller vonstatten geht, wird die Box 
beim Verschieben innerhalb des Bildschirms kopiert, also 
nicht durch draw_dial() neu gezeichnet. Um das ganze flim- 
merfrei erledigen zu können, ist folgender Ablauf denkbar: 


A Bildschirmhintergrund komplett retten 

B Dialogbox ein erstes Mal zeichnen [durch draw_dial()] 

C beim Verschieben zuerst die Box an die neue Position 
kopieren und nur die benötigten Teile des Originalunter- 
grunds wiederherstellen (also die Differenz zwischen der 
neuen und der alten Position) 


Leider kann diese flimmerfreie Methode schon einiges an 
Speicherplatz für den Bildpuffer kosten (man denke nur an 
Großmonitore mit 1024x768 oder mehr Pixeln Auflösung). 

Ein letzter Tip betrifft das Wiederherstellen einer einmal 
gemachten Positionierung von MOVEDIAL-Boxen auf dem 
Bildschirm. Da nach jedem Neustart eines Programms mit 
MOVEDIAL-Boxen diese insgesamt neu positioniert werden 
müssen, wäre eine Methode vorteilhaft, die alle Dialogbox- 
Positionen wieder herstellen kann. Dazu müßten auf Wunsch 
alle Positionen in einer Datei abgelegt und bei Programmstart 
wieder eingelesen werden können (ähnlich DESKTOP.INF). 
Dabei muß allerdings jeweilsnoch eine Auflösungsanpassung 
vorgenommen werden. Wenn man sich vorstellt, daß beim 
Abspeichern der Positionen ein Monitor mit einer Auflösung 
von 1024x768 Pixeln verwandt wurde und einige Boxen am 
unteren Bildschirmrand positioniert waren, wird klar, daß ein 
Wiederherstellen dieser Dialogboxpositionen bei einer 
640x400-Pixel-Auflösung schiefgehen muß. Man könnte die 
Auflösung, die beim Abspeichern eingestellt war, mit in die 
Info-Datei ablegen, um so die Dialogboxpositionen auf die 
aktuelle Auflösung bei erneutem Programmstart rückrech- 
nen zu können. 
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Universelle 
Dialogbox 


Warum viele Dialogboxen für verschie- 
dene Zwecke konstruieren, wenn eine 
einzige denselben Zweck erfüllt? Edit- 
Felder variabler Länge machen. es mög- 
lich. Dabei benötigt man weniger Spei- 
cherplatz und muß sich mit weniger 
Feldnamen und Adressen belasten. 


tellen Sie sich ein Programm vor, in dem Sie dem 
S Benutzer die Möglichkeit bieten wollen, über die Breite 
und Art der Edit-Felder einer Dialogbox frei entschei- 
den zu können (z.B. Adimens Init). Denken Sie an ein Pro- 
gramm, in dem der Benutzer in unterschiedlichen Dialogbo- 
xen verschiedene Einträge ganz bestimmter Art und Länge 
machen soll; oder wollen Sie ein Programm erstellen, das 
Edit-Felder mit mehr als 40 Buchstaben benötigt, dann kann 
Ihnen die hier vorgestellte Routine einige Anregungen bieten. 
Wir wollen das Problem durch Konstruktion eines einzigen 
Objektbaums lösen, den man durch Modifikation während 
des Programmlaufs den jeweiligen Bedürfnissen anpaßt. 


Vorarbeiten 


Zum Studium der Objekt- und TEDINFO-Struktur verweise 
ich auf die in ST Computer bereits erschienenen Artikel sowie 
auf das Handbuch Ihrer Programmiersprache. 

Für eine variable Dialogbox benötigen Sie eine Anzahl von 
Zeichenketten (im Beispielprogramm 14 mit einer Länge von 
80 Zeichen). Für diese müssen Sie Speicher reservieren bzw. 
eine Struktur schaffen. Des weiteren werden in der TEDIN- 
FO-Struktur in den letzten beiden Einträgen (Länge der 
Textzeichenkette und des Maskentextes) Platzhalter einge- 
setzt (hier -2), die im späteren Programm jeweils auf die 
aktuellen Werte gesetzt werden müssen. 

Natürlich benötigen wir auch eine Objektstruktur für die 
Dialogbox. Hierin sind die Breiten der Edit-Felder und somit 
der ganzen Box sowie die x-Koordinaten aller Objekte mit 
Platzhaltern zu versehen. Vergessen Sie nicht, das letzte 











Aufruf: var_edit(tree, index, n, pt, tx, vl) 
Funktion: richtet Edit-Felder und Boxtitel ein 
Parameter: tree: Zeiger auf (Dialogbox-)Objekt 
index: Index des zu verändernden 
Objekts 
n: Länge des Textes bzw. des 
Edit-Feldes 
pt: Zeiger aus Maskentext 
tx: Zeiger auf Text 
val: Zeiger auf Validitätszeichen 
9: nur Ziffern 


X: alle Einträge erlaubt 
Rückgabewert: Adresse des Textes 


Aufruf: hndi_dial(tree, cur, x, y, w, h) 
Funktion: Dialogboxbehandlung 
Parameter: tree: Zeiger auf (Dialogbox-J)Objekt 


cur: Objektindex des Edit-Feldes, auf 
dem der Cursor erscheinen soll 
x, y, w, h: x- und y-Koordinate, Breite 
und Höhe der Dialogbox 
Rückgabewert: angeklicktes Objekt 











Objekt mit LASTOB zu versehen. Bei der Steuerung des 
Schreib-Cursors für die Edit-Felder mittels der Pfeiltasten 
kommt es sonst zu einem Totalabsturz. 

Zur jeweiligen Darstellung einer Dialogbox müssen die 
Platzhalter durch aktuelle Werte ersetzt werden. Wenn ein 
Objekt n Buchstaben enthält, werden dazu 8*n Bildpunkte 
benötigt. Links und rechts sollten Sie einen Rand lassen (im 
Programm je 30 Punkte). Die Routine var_edit() wird danach 
zum Einrichten der variablen Felder aufgerufen. Dabei erhält 
Sie bei jedem Aufruf die Adresse des (Dialog-)Baums, den 
Objektindex des zu ändernden Eintrags, die Anzahl der 
Buchstaben, den Maskentext und ein Validitätszeichen (‘9’ 
bedeutet ‘nur Ziffern; ‘X’: jeder Eintrag ist erlaubt). 

Zur Bearbeitung der Dialogbox steht Ihnen die Routine 
hndl_dial() zur Verfügung. Diese zeichnet die Dialogbox zen- 
triert und setzt den Cursor auf ein freibestimmbares Edit- 
Feld. Als Rückgabewert wird die Nummer des angeklickten 
Objekts geliefert. 


Anregung 


In ähnlicher Form lassen sich alle Arten von Objekten verän- 
dern, verschieben (siehe ‘'Bewegliche Dialogboxen’ in die- 
sem Heft), verstecken oder mehrfach nutzen. Versuchen Sie 
doch, zur Übung eine Box mit einem Titel- und einem 
einzigen Edit-Feld zu entwerfen, in das Sie nacheinander bei 
jedem Aufruf etwas anderes eingeben können. Versuchen 
Sie es vielleicht mit einem Paßwort, Ihrer Konto- und Ihrer 
Telefonnummer. 

Achten Sie dabei auf den Maskentext und die Anzahl der 
einzugebenden Zeichen sowie auf ihre Gültigkeit. Mit ein 
wenig Übung können Sie bald komplizierte Dialogboxen 
zusammensetzen. 


Spracherweiterungen 


Heutzutage sind höhere Programmiersprachen in den meisten Fällen in komplette Entwicklungsumgebungen 
eingebunden und mit einer Reihe von Zusatzfunktionen versehen. Diese dienen der Erweiterung des jeweiligen 
Sprachenstandards und der leichteren Programmierung des Rechners (z.B. GEM-Bibliothek). Manchmal sucht man 
aber gerade eine, für sein Programm benötigte Erweiterung, umsonst. Dann können Routinen oder, für einen 
größeren Themenkomplex, eine ganze Bibliothek sehr von nutzen sein. Man findet diese in den einzelnen 
Computerzeitschriften oder kann Sie als Spracherweiterungen kaufen (siehe Übersicht im Utilitie-Teil). Auf den 
folgenden Seiten finden Sie 8 Erweiterungen (von der Speicherverwaltung über dynamische lokale Variablen bis hin 
zu Mengen) für die Programmiersprachen C, PASCAL und BASIC. 


Dynamische lokale Variablen in C 
Ein wenig Stack-Akrobatik ...zeaeeesesenenennnnnennnnnnnnnnnnnnnnnn 120 


GDOS-Zeichensätze in MAXON-PASCAL 
Es muß nicht immer der Systemzeichensatz sein ....... 121 


Memory Manager 
Leistungsfähige Speicherverwaltung in C 





Mengen in C 

Bibliothek für Mengenoperationen ...zununnasasnnnennnennnnnen 128 
Exget 

Erweiterte GET-Funktion für © aeeeeenseseesenasenensnenenennnenenn 130 


Eingabe mit Stil 
Erweiterter INPUT-Befehl in GFA-BASIC „anna. 131 


Installieren von STAD-Fonts 
GEM-Fonts in GFA-BASIC- 
Programmen verwenden 
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Dynamische, 


lokale 


Variablen in C 


In C muß der Platzbedarf von lokalen (automa- 
tischen) Variablen bereits zur Übersetzungs- 
zeit bekannt sein. In diesem Artikel wird eine 
einfache Funktion vorgestellt, mit derzur Lauf- 
zeit Platzfür weitere lokale Variablen geschaf- 
fen wird, die genauso wie vom Compiler be- 
reitgestellte beim Verlassen der Funktion ‘zer- 
stört’ werden. 


iese Funktion nenne ich in Anlehnung an [1] alloca(), 
D und sie ist wie folgt deklariert: void *alloca(unsigned int 

size). Im Listing finden Sie die Funktion als Assembler- 
Programm. Dieses können Sie beim Linken Ihres Programms 
anfügen. 


Stack-Akrobatik 


Am Anfang jeder C-Funktion befindet sich ein LINK A6,#x. 
Dieser Befehl sichert zunächst den Wert von A6 auf den 
Stack. Das ist erforderlich, damit alle Funktionen das gleiche 
Register verwenden können. Dann wird der Stackpointer (SP 
bzw. A7) nach A6 gebracht und der Wert x (er muß negativ 
sein) zum SP addiert. Effekt dieser komplizierten Angelegen- 
heit ist, daß auf dem Stack ein ‘Loch’ entsteht. Dieses Loch 
wird als Platz für die Iokalen Variablen benutzt. Zusätzlich hat 
man in A6 einen Zeiger auf das obere Ende des Lochs, der 
zum Zugriff auf die Variablen verwendet wird. Am Ende der 
Funktion muß dann der Befehl UNLK A6 erfolgen. Damit wird 
das ganzerückgängig gemacht, d.h.A6in den SP übertragen 
und der alte Wert von A6 vom Stack geholt. Danach sieht der 
Stack wieder so aus wie vor dem LINK-Befehl. Und genau 
diese Tatsache, daß UNLK keine Information benötigt, wie- 
viel Platz durch LINK reserviert wurde, macht sich alloca() 
zunutze. 


Funktionsweise 


Man kann sich die Vorgänge anhand der Grafiken im Bild 
vorstellen. Ganz links sieht man den vorher geschilderten 
Zustand. Beim Aufruf von alloca() wird der Parameter size auf 
den Stack geschoben, ebenso die Rücksprungadresse. allo- 
ca() holt als erstes die Rücksprungadresse vom Stack und 
merkt sie sich in AO. Jetzt kommt der eigentliche Sinn der 
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Aufruf: alloca(size) 
Funktion: Reserviert auf Stack Platz für lokale 
Variablen 
Parameter: size: Größe des zu reservierenden 
Speichers 
Rückgabewert: Zeigeraufreservierten (Stack-)Speicher- 
bereich 


Sache: Vom SP wird der Wert size abgezogen, genauso wie 
es LINK tut. Es hat auch denselben Effekt: auf dem Stack 
entsteht wiederum ein Loch. Nur ist die Größe des Lochs 
nicht im Programm festgeschrieben, sondern wird von size 
angegeben. Damit hätten wir unseren dynamisch allozierten 
Speicher. Nun muß alloca() noch einen Zeiger auf diesen 
Speicher zurückgeben, und das ist SP+2. Dieser Wert wird in 
DO geladen und mit JMP(AO) zurückgesprungen. Die Rück- 
sprungadresse haben wir ja vom Stack heruntergeholt, also 
ist RTS nicht möglich. 

Warum ist eigentlich der Zeiger SP+2? Die aufrufende 
Funktion muß nach der Rückkehr noch eine Stack-Korrektur 
durchführen, d.h. den Platz für die Parameter wieder freige- 
ben. In unserem Fall sind das 2 Bytes. Nach dem JSR alloca 
setzt der Compiler also noch ADDQ.L #2,SP (oder so ähn- 
lich). Daher beginnt der allozierte Speicher nicht bei SP, 
sondern bei SP+2. Er wird aber dadurch nicht kürzer, da der 
Platz, den der Parameter (size) eingenommen hat, jetzt zum 
allozierten Speicher gehört. 


Nun die schlechte Nachricht ... 


So schön wie alloca() funktioniert, im Leben gibt es leider 
keine Vorteile ohne Nachteile. Und der Nachteil von alloca() 
ist, daß eine Funktion, die dynamische lokale Variablen nutzt, 
keine Registervariablen benutzen darf. 

Die Erklärung ist einfach: Werden Register verwendet, 
müssen deren alte Inhalte irgendwohin gerettet werden, man 
will ja nicht die Registervariablen einer aufrufenden Funktion 
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zerstören. Der Compiler macht das, indem er die in Frage 
kommenden Register mit einer MOVEM-Anweisung auf den 
Stack schiebt und vor dem Rücksprung wieder zurückholt. 
Und das Ablegen geschieht unglücklicherweise genau unter 
den lokalen Variablen. alloca() würde seinen Speicher jetzt 
unterhalb der Register anlegen, so daß beim Funktionsende 
nicht die alten Registerwerte zurückgeholt würden, sondern 
der Inhalt des dynamischen Speichers, was natürlich Unsinn 
ergäbe. 

Es wäre zwar eine Änderung an alloca() denkbar, die die 
geretteten Registerwerte nach unten verschieben und auf 
diese Weise Platz reservieren würdet. Doch leider ist die 
Länge des Registerbereiches nicht bekannt, nur die Länge 
Register + lokale Variablen (A6-SP). Man müßte also, wenn, 
die beiden zusammen verschieben, um neuen Platz auf dem 
Stack zu gewinnen. Bitte denken Sie selbst alle Möglichkei- 
ten durch (ich habe mir lange genug den Kopf zerbrochen). 


: ; alloca() reserviert Platz auf dem Stack 
Die aufrufende Funktion darf keine 
Registervariablen verwenden ! 

(c) 1992 MAXON Computer 


: alloca: move. (a7)+,a0 ; Rücksprungadr. 


move. (a7),do 
suba. 40,7 


move. a7,d0 
addg. #2,d0 


jmp (a0) 





Die alloca()-Funktion 


Wenn nicht eine der beiden Teillängen bekannt ist, kommt 
entweder Unsinn heraus, oder die vorher vorhandenen Inhal- 
te der lokalen Variablen gehen verloren. Und das ist nun 
wirklich nicht der Sinn von dynamischem Speicher. 


GDOS-Zeichensätze 
in MAXON-Pascal 


MAXON-Pascal bietet durch die Units GEMVdi 
und GEMAes vollen Zugriff auf alle VDI- und 
AES-Routinen. So ist es auch kein Problem, 
das GDOS zu integrieren, um so eine große 
Hardware-Kompatibilitätzu erreichen. Alsklei- 
ne Anregung möchte ich zeigen, wie man 
GDOS-Bildschirmzeichensätze in eigene Pro- 
gramme einbindet. 


Programm, das die Verwaltung von verschiedenen 

Gerätetreibern (Bildschirm, Drucker, Metafile etc.) mit 
den dazugehörigen Zeichensätzen übernimmt. Über das 
GDOS ist somit eine komfortable Kommunikation zwischen 
eigenen Programmen und der Hardware möglich. Bei einem 
Wechsel der Hardware muß nur das GDOS angepaßt wer- 
den, und somit ist das eigene Programm ohne Anpassung 
auf einer Vielfalt von Hardware-Zusammenstellungen (z.B 
TT, Großbildschirm, Beschleunigungskarten etc.) lauffähig. 
Trotz dieser Möglichkeit hoher Kompatibilität wird das GDOS 


D as GDOS (Graphics Device Operating System) ist ein 
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Das ist ein GDOS-Zeichensatz ! 







































































Bild 1: Die geladenen GDOS-Zeichensätze können für die Schriftausgabe 
im Fenster gewählt werden. Der ausgewählte Schrifttyp wird dann im 
Menü mit einem Haken gekennzeichnet. 


von den meisten Programmierern immer noch stiefmütterlich 
behandelt, obwohl es in den meisten Programmiersprachen 
sehr leicht über die VDI-Aufrufe genutzt werden kann. Diese 
Unbeliebheit folgt wahrscheinlich aus seiner geringen Ge- 
schwindigkeit. Aber durch die Entwicklung hin zu Beschleu- 
nigungskarten und Programmen (NVDI, Quick ST etc.) bzw. 
zu schnelleren Rechnern (TT und Mega STE) wird dieses 
Manko immer mehr aufgehoben. Ich möchte zur Demon- 
stration des GDOS ein kleines Programm in MAXON-Pascal 
vorstellen, das die GDOS-Bildschirmzeichensätze nutzt. 

Im folgenden möchte ich auf das Zusammenspiel zwischen 
GDOS und VDI eingehen und die von mir benutzten VDI- 
Routinen genau beschreiben: 
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Das GDOS lädt beim Starten die Datei ASSIGN.SYS, in der 
die zu ladenden Gerätetreiber und Zeichensätze aufgeführt 
sind. Nähere Information über Aufbau und Bedeutung dieser 
Datei findet man in [2]. Die in dieser Datei angegebenen 
Zeichensätze für den Bildschirm wollen wir nun mit unserem 
Programm einladen und zur Textausgabe im Fenster einset- 
zen. Zum Laden benutzt man die Funktion 


anzahl:=vst_load_fonts(vdi_handle, select); 
anzahl,vdi_handle,select: INTEGER; 


die alle verfügbaren Zeichensätze in den Speicher lädt und 
uns die Anzahl der geladenen Zeichensätze übergibt. Man 
übergibt ihr als Parameter das Vdi_handle (die Kennung, die 
man beim Öffnen der virtuellen Workstation erhalten hat) und 
den Wert select = 0. Zur Auswahl zwischen den einzelnen 
Zeichensätzen dient uns die Prozedur 


vst_font(vdi_handle,font); 
vdi_handle,font: INTEGER; 


wobei font den Index des jeweiligen Zeichensatzes darstellt. 
Allerdings haben wir beim Laden noch keinerlei Informatio- 
nen über die Indizes oder die Namen unserer geladenen 
Fonts erhalten. Hier hilft die Funktion vgt_name. Dieser 
Routine übergibt man als Parameter elementnum, als wie- 
vielter der Zeichensatz geladen wurde (hierbei zählt der 
Systemzeichensatz als Nummer 1) und erhält Name und 
Index zurück. 


index:= vqt_name(vdi_handle, elementnum,name); 


index,vdi_handle,elementnum: INTEGER; 
name: STRING80; 


Jetzt kann man die Zeichensätze leicht mittels vst_font 
auswählen. Am Programmende werden die Zeichensätze 
mittels vst_unload_fonts aus dem Speicher gelöscht: ' 


vst_unload_fonts(vdi_handle, select); 


In select übergeben wir wieder den Wert 0. Weitere Informa- 
tionen über diese Routinen findet man in [1] und [2]. Im 
englischsprachigen Handbuch sind die Parameter leider 
teilweise falsch beschrieben. 

VDI-Aufrufe, die das GDOS benötigen, wie z.B. vst_load_- 
fonts, verabschieden sich bei nicht installiertem GDOS in der 
Regel mit ein paar Bomben. Leider gibt es keine VDI-Routine, 
die das Vorhandensein von GDOS überprüft. Es gibt aber 
eine von Atari beschriebene Routine, die überprüft, ob GDOS 
installiert ist.[1] Die Funktion liefert den Wert 0, falls GDOS 
nicht installiert ist. Ich habe diese RoutinemitNamemvq_gdos 
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in Assembler mitaufgeführt. Man muß die Routine nur mittels 
Inline-Anweisungen einbinden. 


Menübehandlung 


Um im Programm zwischen den einzelnen Zeichensätzen 
wählen zu können, möchte ich den Schriften Menüeinträge 
zuordnen. Dazu erstelle ich zuerst mit Hilfe eines Resource 
Construction Sets einen Menübaum mit drei Titeln: 
GDOS_Demo, Programmende und Schriften. Im Menü Schrif- 
ten benenneich die Box, in der sich die Einträge befinden, als 
MENU_BOX. Dann kann ich später über die Object-Struktur 
auf die Größe der Box zugreifen. Ich füge nun 10 Einträge mit 
der Länge von 18 Zeichen und dem Text unbelegt ein. In 
diese trage ich während des Programmablaufs die Zei- 
chensatznamen mittels menu_text ein. (Deshalb unbedingt 
auf die Länge von 18 Zeichen achten). Jetzt gebe ich dem 
ersten Eintrag den Namen SCHRIFTT. Zum Schluß brauche 
ich nur noch dem Quit- und dem Infoeintrag einen Namen zu 
geben, (siehe auch Listing ZEICHEN.I) und man kann mit 
dem Programmieren loslegen. 

Jetzt ein paar Worte zum gesamten Programmaufbau: 
Nach einer Überprüfung der GDOS-Installation und erfolgrei- 
cher GEM-Initialisierung laden wir die Zeichensätze und 
erfragen deren Namen und Index. Die Namen tragen wir ins 
Menü Schriften ein. Wir verstecken nun noch restliche Menü- 
einträge und passen die Größe der Menübox an. Der System- 
Font wird als aktueller Zeichensatz im Menü abgehakt darge- 
stellt. Damit ist die Routine Menü_Vorbereitung abgeschlos- 
sen. Nun öffnen wir ein Ausgabefenster, indem wireinen Text 
ausgeben, damit wir die Zeichensätze auch sehen können. 
Jetzt kann man bequem mit Hilfe des Menüs zwischen den 
Schrifttypen umschalten. 

Hat man in aller Ruhe alle Schriften bewundert, kann man 
das Programm beenden. Jetzt wird das Fenster geschlossen 
und gelöscht. Dann löschen wir noch das Menü und die 
Zeichensätze aus dem Speicher und melden uns bei GEM 
ab. 


; Assembler-Routine zur Überprüfung der GDOS- 
Installation 


: VQ_GDOS: move.l (a7)+,a0 ;Rücksprungadresse 
merken 
move.w #-2,d0 


trap #2 
emp.w #-2,d0 
sne ao 
ext.w do 
move.1 d0, (sp) 
jmp (a0) 


; zurück zum 
Hauptprogramm 





Routine zur Überprüfung der GDOS-Installation 
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Memory 
Manager 


Wer ausgiebig Gebrauch von den Lieblings- 
kindern der Informatik - Datenstrukturen wie 
Records und daraus entstehendenListen, Bäu- 
men, Schlangen usw. - macht, ist auf die 
dynamische Zuteilung von Speicher durch das 
den Speicher-Heap verwaltende GEMDOS an- 
gewiesen, muß also zur Laufzeit des Pro- 
gramms immer wieder anfragen, ob denn 
weitere Bytes für ein neues Listenelement o.ä. 
zu bekommen seien. 


größere Blöcke, wie sie beim Laden und Starten eines 
Programmes erforderlich werden. Natürlich darf man 
auch z.B. lediglich 12 Bytes für ein kleines Listenelement 
anfordern; versucht man dies jedoch mehr als etwa 300mal, 
so ist das Betriebssystem schon bald an den Grenzen seines 
internen Verwaltungsspeichers, wo es die 16 Byte großen 
sogenannten Memory-Deskriptoren (MDs) für die vergebe- 
nen Miniblöcke ablegt [3][4]- 
In diesem Fall hört man oft den gutgemeinten Rat, sich 
einen großen Speicherbereich vom Betriebssystem zu holen 
und diesen dann selbst zu verwalten. Aber wie? 


A usgelegt ist dieseSpeichervergabe abereherfüreinige 


Auf die Finger geschaut 


Verschiedene Hochsprachen-Compiler stellen eigene Routi- 
nen zur Speicherverwaltung zur Verfügung, die das Betriebs- 
system insbesondere bei der Anforderung kleiner Blöcke für 
Strukturvariablen (Records) entlasten sollen. 

Eine Untersuchung beispielsweise der von Turbo-C 2.0 zur 
Verfügung gestellten Routinen malloc, free usw. zeigt jedoch 
‚daß auch hier nicht der Weisheit letzter Schluß realisiert 
wurde. Es handelt sich um eine Modifikation der in [1] 
vorgestellten Speicherverwaltung. 

Angeforderte Blöcke ab 4 KByte werden direkt vom Be- 
triebssystem geholt und bei der Freigabe auch direkt an 
dieses zurückgegeben. Zusätzlich werden aber auch verket- 
tetesogenannte Memory Cluster miteiner Größe von8KByte 












Aufruf: initLmemory_manager(start_adress, 
size) - 
Funktion: initialisiert interne Verwal 
strukturen 2 
Parameter: start_adress:Zeiger auf den v 
den Speicherbet 
size: Größe des zu verwaltei 


Rückgabewert: 0: alles ok; -1: Fehler 


Aufruf: mm_malloc(desired_size) 

Funktion: gibt Speicherbereich (aus zu verwalten- 
dem) zur Benutzung frei 

Parameter: desired_size: gewünschte Speicher- 


größe 
Rückgabewert: void-Zeiger auf reservierten Speicher- 
bereich; NULL im Fehlerfall 
Aufruf: mm_calloc(number_of_itens, 
size_of_items) 
reserviert Speicherbereich [wie malloc(]; 
als Parameter wird jedoch nicht die ge- 
samt benötigte Größe, sondern die An- 
zahl der Elemente und die Größe eines 
einzelnen Elemets übergeben 
number_of_items: Anzahl der 
Feldelemente 
(Byte-)Größe eines 
Elements 
Rückgabewert: void-Zeiger auf reservierten Speicher- 
bereich; NULL im Fehlerfall 


Funktion: 


Parameter: 


size_of_items: 


Aufruf: 
Funktion: 


mmı_realloc(block, new_size) 

nachträgliche Änderung der Größe ei- 

nes angeforderten Speicherblocks. Wird 

ein neuer Block benötigt, kopiert die 

Routine die Werte aus dem alten Block 

in den neuen 

block: Zeiger auf Speicherblock 
[lieferte mm_malloc() oder 
mm_calloc()] 

new_size:neue Größe des Speicher- 
blocks 

Rückgabewert: Zeiger auf neuen Speicherblock; NULL, 

wenn Größenänderung nicht möglich 


Parameter: 











selbst verwaltet, aus denen heraus dann Blöcke von weniger 
als 4 KByte Länge vergeben werden. 

Kommt es nun also zu einer solchen Anforderung eines 
kleinen Blocks, wird zunächst geprüft, ob bereits Memory 
Cluster vorhanden sind, und wenn ja, ob in einem der Cluster 
noch freier Speicher der angeforderten Größe vorhanden ist. 
Ansonsten wird zunächst ein weiterer 8 KByte (genau 8208 
Bytes, also 8 KByte plus zwei mal 8 Bytes für initiale Verwal- 
tungseinträge) großer Speicherblock vom Betriebssystem 
angefordert und in die Cluster-Verkettung eingefügt. Dann 
wird Speicher in der gewünschten Größe von dem Cluster 
abgeteilt und mit einem 8 Byte großen Datenkopf versehen, 
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der zur späteren Identifizierung bei der Rückgabe dient. 
Wurden alle Blöcke aus einem Cluster wieder freigegeben, 
wird dieser wieder komplett an das GEMDOS zurückgege- 
ben. 

Letztendlich stößt man natürlich auch hier irgendwann auf 
die 0.9. Grenzen, denn die Cluster müssen ja ebenfalls aus 
dem Hintergrund vom Betriebssystem herangeschafft wer- 
den. Das Problem ist allerdings nicht sehr gravierend, denn 
durch die Pufferung des Speichers in den Clustern lassen 
sich immerhin etwa 2.5 MByte Speicher auch für beliebig 
viele kleine Speicheranforderungen verwalten. 


Selbsthilfe 


Trotzdem gab es durch eine konkrete Problemstellung Grün- 
de, eine eigene Speicherverwaltung auszutüfteln. Ein Pro- 
gramm erforderte die Aufteilung des zur Verfügung stehen- 
den Speichers in zwei Teile: zum einen in einen Puffer für 
Dateien, der möglichst groß sein sollte, und zum anderen 
einen Verwaltungsspeicher, der dementsprechend auf ein 
Mindestmaß beschränkt bleiben mußte. Der erstgenannte 
Puffer mußte eine unveränderliche Größe haben, so daß der 
verbleibende Speicher alle dynamisch erzeugten Daten- 
strukturen von sehr unterschiedlicher Größe (16 Bytes bis 32 
KBytes) aufzunehmen hatte. 

Läßt man dem GEMDOS nun aber z.B. 100 KBytes übrig, 
um diese dann über klassische (C-) mallocs anzufordern und 
so als Verwaltungsspeicher zu nutzen, wird dieser Bereich 
nicht optimal genutzt. Einige hundert Speicheranforderun- 
gen für sehr kleine Datenstrukturen und diverse benötigte 
Blöcke mit Größen von 1 bis 32 KByte fragmentieren den 
Speicher recht schnell, da beispielsweise der Übergang von 
einem zum nächsten Speicher-Cluster nicht genutzt werden 
kann, selbst wenn diese im Speicher direkt nebeneinander 
liegen. So können am Ende der Cluster freie Bereiche übrig 
bleiben, die wegen einer geringfügig größeren Anforderung 
vorerst nicht genutzt werden können. Stattdessen wird ein 
neuer Cluster vom Betriebssystem geholt. Weiterhin kann 
freier Speicher am Anfang und Ende eines solchen Clusters 
nicht mit dahinter- oder davorliegendem GEMDOS-Freispei- 
cher zu einem größeren Block verschmelzen, solange er 
wegen geringfügiger Belegung unter der Fuchtel der zusätz- 
lichen Speicherverwaltung steht. 

Ungünstig wird die Speicherauslastung dieses Verwaltung- 
sbereiches auch von der Vielzahl sehr kleiner Datenstruktu- 
ren beeinflußt, da für jede Zuteilung neben der angeforderten 
Menge auch noch 8 Bytes für die Verwaltung anfallen, die 
ebenfalls in dem Cluster als Header vor dem vergebenen 
Block abgelegt werden. So wächst der effektive Speicherbe- 
darf der zahlreichen kleineren Strukturvariablen mit Längen 
von 16-32 Bytes um 25-50% über die eigentliche Datenmen- 
ge hinaus an. 


Zur Sache 


Diese Problematik taucht im Prinzip immer dann auf, wenn 
man nicht in Megabytes schwelgen kann, sondern den 
Speicherbedarf minimieren möchte. Dies ist zum Beispiel bei 
Accessories nötig, die ja mit so wenig Speicher wie möglich 
auskommen sollen, zumindest während sie inaktiv sind. 
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Aufruf: mm_free(block) 

Funktion: gibt reservierten Speicher (nach Plau: 
bilitätsprüfung) wieder frei : 

Parameter: block: Zeiger auf Speicherblock 


Rückgabewert: 0: alles ok; -1: Fehler 


Aufruf: mm_coreleft() 

Funktion: Ermittlung der Größe des größten noch 
freien Speicherbereichs 

Parameter: keine 


Rückgabewert: Größe des Speicherbereichs 


Aufruf: mm_total_coreleft() 

Funktion: Ermittlung des gesamten noch 
nutzbaren Netto-Speichers 

Parameter: keine 


Rückgabewert: gesamt vorhandener freier Speicher 


Aufruf: mm_number_of_fragmenst() 

Funktion: ermittelt Anzahl der Bereiche, in die 
der freie Speicher [siehe 
mm_total_coreleft()] unterteilt ist 

Parameter: keine 

Rückgabewert: Anzahl der noch freien Speicher- 
bereiche 











Die hier vorgestellte Speicherverwaltung wird einmalig zu 
Programmbeginn mit einem festen Speicherbereich initiali- 
siert, aus dem sie fortan dynamisch Speicherblöcke verge- 
ben kann. Nach außen hin geschieht dies mit denselben 
Funktionen, wie sie auch in C verwandt werden. Lediglich 
ihre Aufrufsyntax ist etwas verändert, um sie unterscheiden 
zu können. 

Der zu verwaltende Speicherbereich kann über Malloc 
anfangs geholt werden, kann aber auch ein im Programm- 
codereserviertes Feld sein. Dies ist insbesondere bei Acces- 
sories wichtig, die Daten über ihre aktive Phase hinaus 
behalten sollen. Mittels Malloc allozierter Speicher wird bei 
Accessories ja bei Terminierung des Elternprozesses mit 
freigegeben [3]. 

Die freien Speicherblöcke erhalten jeweils eine MEM_- 
BLOCK-Struktur (siehe Abb. 1) als Datenkopf, der die Infor- 
mation über die Größe des Blocks enthält, und einen Zeiger 
auf den im Speicher folgenden Block. 

Die Hauptverbesserung gegenüber den in [1] und [2] vorge- 
schlagenen Speicherverwaltungen ist die Beschränkung auf 
ein Minimum an Verwaltungsdaten für die vergebenen Blök- 
ke. Ganz ohne eine Information über die Größe des vergebe- 
nen Blockes kommt man natürlich nicht aus, denn bei der 
Freigabe kann man jaaus der Startadresse noch nicht auf die 
Länge schließen. 

Bei der 0.g. Problemstellung waren ausschließlich Blöcke 
von weniger als 64 KByte zu vergeben, was wohl auch sonst 
der weitaus häufigste Fall zur Laufzeit eines Programms sein 
dürfte. Für diese Blöcke reicht es aber aus, ihre Größe in 
einem vorzeichenlosen Integer - also in nur 2 Byte - zu 
speichern. Lediglich für Blöcke mit einer Größe von mehr als 
64 KByte wird ein long erforderlich. Nun kann man aus der 
Anfangsadresse eines freigegebenen Blocks ebenfalls nicht 
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ermitteln, ob der Block mit einem 

















long oder einem int als Datenkopf Freispeicherblock | nächster Größe ieilk. ) 
versehen ist. Deswegen muß man (MEM_BLOCK) Block 
dem größeren Blocksinsgesamt 6 
Bytes Datenkopf gönnen (Abb. 1). = 
Bei Rückgabe eines Blocks Userblock < 64 KB |Eröße| itzbar.... 
schautman sich zunächst diezwei (SMALL_BLOCK) UInt) 


Bytes vor dem übergebenen Zei- 
ger an. Steht dort eine Null, han- 
deltessichumeinengroßenBlock, 
dessen Größe nun weitere vier 
Bytes vorher ausgelesen werden 
kann. In den anderen Fällen sind 


Jserblock > 64 KB 
(LARGE_BLOCK) 








von 'hjr_malloc' gelieferter Zeiger 





Größe 0 








nutzbar... } 


(Long) (Int) 
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von 'hjr_malloc' gelieferter Zeiger 








die zwei Bytes vor dem Zeiger die 
als vorzeichenlose Ganzzahl ab- 
gelegte Größe. Diese zwei verschiedenen Header sind inden 
Datenstrukturen LARGE_BLOCK und SMALL_BLOCK (sie- 
he Abb. 1) ausgedrückt. 

Ansonsten ist keine weitere Verwaltung der Blöcke in ir- 
gendwelchen zusätzlichen Listen erforderlich. Dadurch ver- 
größert sich der Anteil des effektiv nutzbaren Freispeichers 
ganz erheblich; insbesondere bei kleinen Anforderungen 
wird weit weniger Speicher vergeudet. 


Abb. 1: Die Datenstrukturen 


Und so geht's 


Die vorgestellten Routinen werden genauso benutzt, wie die 
Speicherverwaltung des Betriebssystems oder die der C- 
Compiler. Zusätzlich muß allerdings am Anfang eines Pro- 
gramms der zu verwaltende Speicherbereich initialisiert wer- 
den. Diesen Bereich kann man auf beliebige Weise beschaf- 
fen, sei es durch ein zur Compile-Zeit erzeugtes statisches 
Array oder durch Anforderung beim GEMDOS. 

Ein Grundgerüst für C-Programme, das dieses Vorgehen 
demonstriert, zeigt das Listing. MEM_MNGE.H enthält die 
Prototypen für die global zugänglichen Funktionen und ist 
per #include einzubinden. Die eigentliche Speicherverwal- 
tung wird lediglich übersetzt, also ohne Projektdatei com- 


kostet bei uns jede PD-Diskette aus 
„ST-Computer” oder aus unserer Ka- 


talogdisk, die noch über 800 weitere Wir suchen 


piliert. Das entstenende MEM_MNGE.O muß dann zu der 
jeweiligen Applikation dazugelinkt werden, wobei automa- 
tisch nur die tatsächlich verwendeten Routinen eingebunden 
werden. 

Die folgende Erläuterung der relevanten Routinen erfolgt 
mit formlosen Parametern. Die jeweilige genaue Definition 
entnehmen Sie bitte jeweils dem Listing. 


init_memory_manager (Startadresse,Größe) 

Durch den anfänglichen Aufruf dieser Funktion werden die 
internen Verwaltungsstrukturen initialisiert. Man übergibt le- 
diglich die Startadresse und die Größe des zu verwaltenden 
Bereichs. 

Im wesentlichen wird dem Block eineinitiale MEM_BLOCK- 
Struktur als Datenkopf verpaßt und ein zusätzlicher Dummy- 
MEM_BLOCK angelegt, der einen Null-Speicherbereich be- 
zeichnet und als Listenkopf für die Freispeicherverkettung 
dient und nie vergeben wird. Weiterhin werden Beginn und 
Ende des Bereichs in Variablen abgelegt, so daß später 
zurückgegebene Blöcke auf ihre Lage innerhalb dieses Be- 
reichs geprüft werden können. Wenn alles geklappt hat, gibt 
es zur Belohnung eine 0 zurück, ansonsten eine -1. 
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hjr_malloc(Größe) 

Es wird ein Speicherbereich der gewünschten Größe vom 
Freispeicher abgeteilt. Falls dies erfolgreich möglich war, 
erhält man einen typenlosen Zeiger auf den zugewiesenen 
Bereich, ansonsten einen Null-Zeiger. Dieser Bereich darfauf 
jeden Fall nur bis zu der angeforderten Größe benutzt wer- 
den. Schreibt man über diesen Bereich hinaus, zerstört man 
wichtige Verwaltungsinformationen des dahinterliegenden 
Blocks. Die Reaktionen daraufreichen von Bomben (dahinter 
lag Freispeicher) bis zu rätselhaftem Speicherschwund (da- 
hinter lag vergebener Speicher, der nun nicht mehr freigege- 
ben werden kann). 

Zunächst wird die tatsächlich erforderliche Speichergröße 
ermittelt, d.h. zu der gewünschten Größe addieren sich je 
nach Erfordernis zwei oder sechs Bytes für den 
SMALL_BLOCK- bzw. LARGE_BLOCK-Kopf. Danach wird 
die Freispeicherverkettung nach dem ersten Block durch- 
sucht, der größer oder gleich der benötigten Größe ist. 
Dieses ist das sogenannte First-Fit-Verfahren. Man könnte 
auch den Block suchen, der die am besten passende Größe 
hat, also nach dem Best-Fit-Algorithmus. Tatsächlich erge- 
ben sich aber in der Praxis keine Vorteile, die den größeren 
Suchaufwand rechtfertigen würden. Wie Versuche gezeigt 
haben, ist eine bessere Auslastung des Speichers, wie man 
sie intuitiv vermuten würde, nicht gegeben [2]. 

War die Suche nach einem Block erfolgreich, wird dieser 
auf die erforderliche Größe gestutzt, sofern der dann verblei- 
bende Speicher groß genug ist, um eine MEM_BLOCK- 
Struktur aufzunehmen. Diese ist ja für die Verwaltung des 
freien Speichers in jedem Block erforderlich. Reicht der 
Restspeicher nicht dafür aus, wird er einfach mit vergeben, 
so daß der Anwender dann einen geringfügig größeren Block 
erhält, ansonsten wird der zu große Block in zwei Blöcke 
aufgeteilt, von denen der erste genau die gewünschte Größe 
hat. Diese Aufgaben übernimmt die Funktion split-block. 

Schließlich wird der so gefundene und eventuell verkleiner- 
te Speicherblock für die Vergabe vorbereitet, d.h. mit dem 
richtigen Datenkopf versehen. Die Funktionmake_user_block 
übernimmt diesen Teil der Arbeit. Sie liefert dann auch gleich 
den typenlosen Zeiger auf den zwei oder sechs Bytes weiter 
hinten liegenden Bereich, der dem Anwender dann zur Nut- 
zung übergeben wird (siehe Abb. 1). 


hir_calloc(Anzahl,Größe) 

Diese Funktion stellt lediglich eine Erweiterung derhjr_malloc- 
Routine dar, die im wesentlichen die Reservierung von Spei- 
cher für Datenfelder (Arrays) erleichtert. 

Man übergibt der Funktion die Anzahl der Elemente und die 
Größe eines einzelnen Elementes. Es werden dann Anzahl 
mal Größe Bytes angefordert und - falls vorhanden - an- 
schließend mit Null initialisiert. Der Wert der Funktion ist 
ebenfalls ein typenloser oder ein Nullzeiger. 


hjr_realloc(Block,Größe) 

Diese Funktion erlaubt es, die Größe eines bereits angefor- 
derten Blocks nachträglich zu verändern. Sie ist im Gegen- 
satz zu den meisten Speicherverwaltungen wesentlich hart- 
näckiger bei der Durchsetzung der Interessen des Anwen- 
ders. Die Funktion liefert einen neuen typenilosen Zeiger auf 
den Bereich zurück, der der neuen Größenanforderung ge- 
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nügt, oder einen Nullzeiger, falls es keine Möglichkeit gab, 
einen entsprechend großen Block zu organisieren. Diebishe- 
rigen Daten bleiben auf jeden Fall immer erhalten, außer 
natürlich bei einer Verkleinerung des Bereiches, wo der 
hintere Teil des Bereiches abgeschnitten wird. 

Der neue Zeiger muß aber keineswegs mit dem übergebe- 
nen Bereich übereinstimmen, auch nicht bei einer Verkleine- 
rung, wenn diese über die 64-KByte-Grenze hinweg ge- 
schieht. Vielmehr wird in der Regel ein neuer Bereich zuge- 
wiesen, in den die bisherigen Daten herüberkopiert wurden. 
Daher ist nach einem hjr_realloc darauf zu achten, daß 
Zugriffe auf den Bereich nur relativ zu diesem neuen Beginn 
gemacht werden. Bekommt man einen Nullzeiger zurück, ist 
deralte Bereich trotzdem noch aktiv, erließ sich halt nurnicht 
wunschgemäß vergrößern. Man muß also daran denken, ihn 
noch freizugeben, wenn man ihn so nicht mehr brauchen 
kann. 

Nach Übergabe des bisherigen Blockzeigers und der ge- 
wünschten neuen Gesamtgröße wird zunächst geprüft, ob 
der Block vergrößert oder verkleinert werden soll. Eine Ver- 
kleinerung stellt natürlich überhaupt kein Problem dar und 
wird sofort erledigt, wenn der gewonnene Speicher groß 
genug ist, um eine MEM_BLOCK-Struktur aufzunehmen. Die 
Funktion shrink_block präpariert dazu den frei werdenden 
Speicher so, als wäre er ursprünglich alloziert worden. Dann 
wird er mit der serienmäßigen hjr_free-Routine (s.u.) freige- 
geben. Falls der Block über die magische 64-KByte-Grenze 
hinweg verkleinert wird, verkleinert sich natürlich auch der 
Datenkopf um vier Bytes. Dann wird auch der gesamte 
zugewiesene Bereich um vier Bytes verschoben, so daß auch 
nach der Verkleinerung noch alle Daten an demselben Ort 
sind - allerdings nur relativ zu dem zurückgelieferten Zeiger. 

Soll der Block vergrößert werden, sind einige weitere An- 
strengungen erforderlich. Zunächst wird der bequemste Fall 
geprüft, nämlich ob hinter dem zu vergrößernden Bereich 
direkt ausreichend Freispeicher zur Verfügung steht. Wenn 
demsoiist, wird dort die benötigte Portion abgeschnitten und 
an den übergebenen Bereich angehängt. Wenn dadurch 
nicht die 64-KByte-Grenze überschritten wurde, ist alles 
paletti, und es wird genau der Blockzeiger zurückgeliefert, 
der auch übergeben wurde. Daten müssen-überhaupt nicht 
verschoben werden. 

In allen anderen Fällen kommen wir nicht so leicht davon. 
Das kleinste Problem tritt auf, wenn trotz der Möglichkeit zur 
obigen direkten Speichervergrößerung der Block nun größer 
als 64 KBytes wird und wirihn nun mit einem LARGE_BLOCK- 
Header versehen müssen. Dann müssen alle bisherigen 
Daten des Anwenders noch um vier Bytes nach oben ver- 
schoben werden. 

Reicht der Speicher hinter dem Block nicht aus, wird 
dasselbe noch mit dem Freispeicher versucht, der sich 
möglicherweise direkt vor dem übergebenen Block befindet. 
Ist auch hier Fehlanzeige, zeigt sich der Memory-Manager 
geduldig und versucht, ob nicht Vorgänger- und Nachfolger- 
speicher gemeinsam den Speicherhunger des Anwenders 
befriedigen können. Nach Verschieben der Daten und Frei- 
gabe von eventuellem Restspeicher wären dann alle zufrie- 
den. 

Zeichnet sich jedoch immer noch keine glückliche Lösung 
ab, müssen wir den Brute-Force-Weg gehen und einfach 
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frech per hjr_malloc nach Speicher in der gewünschten 
Größe fragen. Sollte dies wenigstens erfolgreich sein, wird 
deralte Block komplett in diesen Bereich kopiert unddann an 
die Speicherverwaltung zurückgegeben. Der Anwender er- 
hält den Zeiger auf den neuen Block. 

In allen anderen Fällen müssen wir durch einen Nullzeiger 
Unfähigkeit zur Erfüllung der Anforderung signalisieren. 


hjr_free(Block) 
Mit dieser Funktion gibt man vormals allozierten Speicher 
zurück, so daß er anschließend zur erneuten Vergabe zur 
Verfügung steht. 

Zunächst wird untersucht, ob es sich bei dem übergebenen 
Block um einen LARGE_BLOCK oder einen SMALL_BLOCK 
handelt. Aus dieser Information gewinnt man dann den 
tatsächlichen Beginn und die Größe des Blocks. Diese Daten 
werden dann der Funktion insert_into_list übergeben, wo sie 
zunächst im Rahmen der Möglichkeiten einer Plau- 
sibilitätskontrolle unterzogen werden. Mit dem Block stimmt 
sicherlich etwas nicht, wenn er mitten in einem Vorgängerbe- 
reich beginnt oder in nachfolgenden Freispeicher hinein- 
reicht. Suspekt wäre auch, wenn die Größe kleiner als eine 
MEM_BLOCK-Struktur wäre, oder wenn die Grenzen des 
Blocks außerhalb des eigentlich verwalteten Bereichs lägen. 
In so einem Fall wird der Block zwecks Schadenbegrenzung 
schlicht ignoriert, was durch einen Rückgabewert von -1 
angezeigt wird. 

Zeigen sich keine Probleme mit den Daten, wird untersucht, 
ob er eventuell mit davor- und/oder dahinterliegendem Spei- 
cher zu einem größeren zusammenhängenden Block ver- 
schmelzen kann. Dies läßt sich einfacher erledigen, als viel- 
leicht zunächst vermutet werden könnte. Eine Null gibt es für 
erfolgreiche Rücknahme des Blocks. 


hir_coreleft() 
Diese Funktion durchsucht einfach die Freispeicherverket- 
tung nach dem größten freien Block und teilt dem Anwender 


dann dessen effektive Größe mit, d.h. die reale Größe abzüg- 
lich eines erforderlichen Datenkopfs Marke LARGE_BLOCK 
oder SMALL_BLOCK. 


hjr_total_coreleft() 

Diese Funktion geht über den üblichen Standard hinaus und 
teilt einem den gesamten noch nutzbaren Netto-Speicher 
mit. 


hjr_number_of_fragments() 

...st als Ergänzung zur Funktion hjr_total_coreleft zu sehen. 
Sie gibt Auskunft über die Fragmentierung des Freispei- 
chers, d.h. in wieviele voneinander isolierte Bereiche der 
verwaltete Speicher zerstückelt ist. Diese beiden letzten 
Routinen kann man während der Programmentwicklung zu 
Effizienzanalysen der Speicherverwendung nutzen. Mankann 
sich dann stichprobenartig „x Bytes freiiny Fragmenten“ o.ä 
ausgeben lassen. 


„Zu guter Letzt 


Die Speicherverwaltung ist in dieser Form sehr effizient, 
sowohl bezüglich der Verarbeitungsgeschwindigkeit und der 
Größe des einzubindenden Codes als auch der Nutzung des 
zur Verfügung gestellten Speicherbereichs. 

Trotzdem gilt es, die angeforderten Bereiche mit größter 
Sorgfalt zu verwenden, denn sie teilen sich den Speicher- 
block mit den vitalen Verwaltungsdaten der Freispeicherver- 
kettung. Man darf also auf keinen Fall über einen angeforder- 
ten Bereich hinaus schreiben. Dies ist aber im Prinzip kein 
wirklicher Nachteil, denn schließlich wäre dann die anfor- 
dernde Applikation irgendwo fehlerhaft. Während hier die 
Speicherverwaltung selbst darunter zu leiden hätte, wären es 
bei einer Verwaltung durch eine zentrale Liste eben andere 
Daten der Applikation, die hinter dem wuchernden Bereich 
abgelegt wären und nun Schaden nähmen. 
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PROGRAMMIERTIPS 


Mengen in C 


In G ist im Gegensatz zu Pascal oder Modula- 
2 kein Mengentyp vorhanden. Mengen spielen 
jedoch eine Rolle in der Cluster-Analyse, der 
kombinatorischen Optimierung und sind Grund- 
lage der formalen Begriffsanalyse, mit der ich 
mich seit einigen Jahren befasse. Grund ge- 
nug, eine eigene Bibliothek zum Rechnen mit 
Mengen in C zu schreiben. 





Klaus Rindfrey 


ie können Mengen im Rechner dargestellt werden? 
W* Element kann in einer Menge vorhanden sein oder 

nicht. Das bedeuten, daßeine Menge durch ein boole- 
sches Array dargestellt werden kann, wobei jedem Element 
ein Array-Eintrag zugeordnet wird. InC bietet essich an, die 
bitweisen Operatoren zu benutzen, man benötigt dann für 
jedes Element nur ein Bit, so daß in einem Wort 16 Elemente 
gespeichert werden können. 

Betrachten Sie die Definition des Typs BitSetType in 
bset_typ.h. Das Array bitset/] enthält die eigentliche Menge: 
Ein Element istgenau dann in der Menge enthalten, wenn das 
entsprechende Bit gesetzt ist. Nun muß man noch wissen, 
wie bitset/] zu interpretieren ist. Dazu dient die Struktur 
BitSetDefType ‚auf die bsdef zeigt: arrlen gibt die Länge von 
bitset/] an, minelem bzw. maxelem das kleinste bzw. größte 
Element der Grundgesamtheit und maxcard die Größe (Kar- 
dinalität) der Grundgesamtheit. mask dient zum Maskieren 
des letzen Feldes von bitset/]. Das kann nötig sein, wenn die 
Größe der Grundgesamtheit nicht durch 16 teilbar ist, so daß 
das letzte Feld nicht voll genutzt wird. Diese überzähligen 
Bits müssen aber immer O sein, dasonstz.B. die Prüfung der 
Teilmengenrelation falsche Ergebnisse liefert. 

Wie können nun die Mengenoperationen konkret in C 
umgesetzt werden? Bei den bitweise Operatoren handelt es 
sich um boolesche Operatoren, die die Bits eines Wortes 
(bzw. Langwortes) einzeln logisch verknüpfen. Wir müssen 
also die Mengenoperationen durch logische Ausdrücke dar- 
stellen und diese dann mit den C-Operatoren schreiben. 
Zwei Beispiele sollen das Vorgehen verdeutlichen: 


1.Die Vereinigung zweier Mengen A und B ist definiert als die 
Menge, die alle Elemente enthält, die in Aoder B enthalten 
sind. Wir benutzen also das bitweise logische oder, in C 
wäre dasAlB. 

2.Schwieriger ist die Umsetzung des Enthaltenseins (Teil- 
mengenrelation). A ist Teilmenge von B, wenn gilt: 
xeA=>xeB. Ein wenn-dann läßt sich mit den bitweisen 
Operatoren nicht direkt schreiben. Man kann sich jedoch 
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Mathematische 
Schreibweise 


Bezeichnung Schreibweise mit 
C-Operatoren für 


int A, B, x 


Vereinigungsmenge 
Schnittmenge 
Differenzmenge A&-B 
Symmetrische Differenz ANB 
Komplement -A 
Teilmenge -AlB==-0 
Element von (Ox1«x)&A!=0 
Disjunkt A&B== 
Kardinalität Nicht möglich 
leere, Menge A== 
Gleichheit A== 


AIB 
A&B 


: /* BSET_TYP.H — Typdefinitionen für Bitsets */ 
/*  (c) 1992 MAXON Computer “ 
ER 
: BitSetDefType - Informationen d.Mengentyps. 
: Interne Struktur - Nicht darauf zugreifen !!! 
nd 
: typedef struct { 
unsigned arrlen; 
unsigned maxcard; 
int minelem; 


Länge von bitset[] */ 
max. Kardinalität */ 
kleinstes mögliches 
Element 72 
Größtes mögliches 
Element “ 
zum Maskieren d. letzten 
Feldes in bitset[].*/ 

} BitSetDefType; 


int maxelem; 


unsigned mask; 


: /* 

* BitSetType — Datentyp für Mengen 

* Interne Struktur - Nicht darauf zugreifen !!! 

“7 

typedef struct { 
BitSetDefType *bsdef; /* zeigt auf Definition 
* des Mengentyps */ 
unsigned bitset[]; /* Menge als Bit-Muster */ 
} BitSetType; 


1% 
BS_OpId - Code f. die möglichen Mengenoperationen 
“ 
typedef enum { 
BS_UNION, BS_INTERSECT, 
BS_INCLUDE, 
BS_EXCLUDE, BS_ISELEMENT, 
BS_ISSUBSET, 
BS_CARDINAL, BS_COMPLEMENT 
} BS_OpId; 


BS_DIFFERENCE, 


BS_ISEQUAL, 





Typen- und Strukturdefinition zur Mengen-Bibliothek 


überlegen (z. B. mit Hilfe einer Wahrheitswertetafel), daß 
der logische Ausdruck a =>b äquivalent istzunotaorb. 
In C muß also gelten -A IB == -0 (d. h. hier müssen alle 
Bits gesetzt sein), wenn A<B.. In der entsprechenden C- 
Funktion wurde die Negation benutzt, um eine Schleife zu 
verlassen, d.h. A& -B != 0, wenn Anicht Teilmenge von B 
ist. 


In der Tabelle sind die wichtigsten Mengenoperationen und 
-relationen und ihre Operatordarstellung zusammengefaßt. 
Lediglich für die Kardinalität (Anzahl der Elemente einer 
Menge) läßt sich keine entsprechende Darstellung finden. 
Hier muß jedes einzelne Bit geprüft und dabei ggf. ein Zähler 


a a  S 


De Ken 
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inkrementiert werden. Kommen wir nun zu den einzelnen 
Bibliotheksfunktionen (bitset.c). Mit der Funktion bs_newset- 
type() wird eine neue Struktur vom Typ BitSetDefType er- 
zeugt. Als Parameter erhält diese Funktion das kleinstmög- 
liche und das größtmögliche Element. Dadurch ist der Gültig- 
keitsbereich der Menge festgelegt. Betrachtet man die Infor- 
mationen in BitSetDefType alsTyp einer Menge, sokann man 
sagen, daß bs_newsettype() zur Laufzeit einen neuen Men- 
gentyp erzeugt. Als Rückgabewert erhält man einen Zeiger 
auf die Struktur oder NULL, falls kein Speicher reserviert 
werden konnte. 

Mit bs_createset() wird eine neue, leere Menge erzeugt. Als 
Parameter übergibt man der Funktion einen Zeiger auf den 
gewünschten Mengentyp, der vorher mit bs_newsettype() 
erzeugt wurde. 

Rückgabewert ist ein Zeiger auf die Menge (bzw. NULL im 
Fehlerfall). Die einzelnen Mengenoperationen wurden sinn- 
voll zusammengefaßt: 


bs_2setop() enthält die Mengenoperationen, die zwei Men- 
gen als Operanden haben und als Ergebnis wieder eine 
Menge liefern (Vereinigung, Durchschnitt, Differenz). 


bs_1setop() enthält die Operationen mit einer Menge als 
Operand (Kardinalität, Komplement). 


bs_elemop() enthält die Operationen, bei denen ein Ele- 
ment und eine Menge verknüpft werden (Einfügen und 
Entfernen eines Elements, Element-von-Relation). 


bs_cmpset() enthält die Vergleichsoperationen für zwei 
Mengen (Teilmenge, Gleichheit). 


Um eine Mengenoperation durchzuführen, haben die Funk- 
tionen einen zusätzlichen Parameter, der angibt, welche 
Operation gemeint ist. Der Typ des Parameters (BS_Opld) 
wurde in bset_typ.h als Aufzählungstyp definiert. Benutzt 
man die in bset_ext.h definierten Makros, so braucht man 
sich um diesen Parameter nicht weiter zu kümmern. Das 
Maskieren von Bits mit dem Strukturelement mask aus Bit- 
SetDefType ist nur dann erforderlich, wenn eventuell unge- 
nutzte Bits gesetzt werden könnten. Dies ist bei dieser 
Version von bitset.c nur bei der Komplementbildung der Fall. 

In bsdemo.c wird die Anwendung der Bibliotheksfunktio- 
nen demonstriert. Es wird zunächst ein Mengentyp setofchar 
definiert, anschließend werden drei Mengen dieses Typs 
erzeugt, mit denen dann einige Operationen durchgeführt 
werden. Außer mit int und char kann man für Elemente auch 
den Aufzählungstyp benutzen. Wir haben somit die gleichen 
Möglichkeiten wie mit SET OF in Pascal ohne die dortige 
Größenbeschränkung. 





Aufruf: bs_newsettype(mine, maxe) 
Funktion: Anlegen von neuem Mengengentyp 
Parameter: mine: kleinstmögliches Element 
maxe: größtmögliches Element 
Rückgabewert: Zeiger auf neuangelegten Mengentyp 


Aufruf: bs_createset(bsd) 

Funktion: erzeugt neue, leere Menge vom Typ bsd 

Parameter: bsd: Zeiger auf Mengentyp [wird von 
bs_newsettype() zurückgeliefert] 

Rückgabe: Zeiger auf neue Menge 


Aufruf: bs_2setop(bs1, bs2, erg, opid) 
Funktion: führt Mengenoperationen mit 2 Operan- 
den aus: bs1 <opid> bs2 -> erg 
Parameter: bs1, bs2: Zeiger auf Mengen (Typen 
müssen gleich sein!); bs1 und bs2 wer- 
den mittels durch opid bestimmter Ope- 
ration verknüpft 
erg: Zeiger auf Ergebnismenge 
opid: gewünschte Operation: 
BS_UNIO: Vereinigungsmenge 
BS_INTERSECT: Schnittmenge 
BS_DIFFERENCE: Differenz- 
menge 
Rückgabe: wenn Ausführung ok: TRUE, bei unter- 
schiedlichen Mengentypen: FALSE 


Aufruf: bs_1setop(bsp, opid) 
Funktion: führt Mengenoperationen mit einem 
“ Operanden aus 
_ Parameter: bsp: Zeiger auf Menge 
= opid: gewünschte Operation: 








BS_CARDINAL: Kardinalität 
berechnen 
BS_COMPLEMENT: 
Komplement berechnen 
Rückgabe: wenn Ausführung ok: TRUE, 


sonst: FALSE 
Aufruf: bs_elemop(e, bsp, opid) 
Funktion: führt Operationen mit einem Element 


und einer Menge durch 
Parameter: © Element 
bsp: Zeiger auf Menge 
opid: gewünschte Operation: 
BS_INCLUDE: Element einfügen 
BS_EXCLUDE: Element entfernen 
BS_ISELEMENT: prüft, 
ob e Element von bsp ist 
Rückgabe: wenn Ausführung ok: TRUE, 
sonst: FALSE 


Aufruf: bs_cmpset(bs1, bs2, opid) 

Funktion: führt Vergleichsoperationen durch 

Parameter: bs1, bs2: Zeiger auf zu vergleichende 
Mengen 


opid: gewünschte Operation: 
BS_ISSUBSET: prüft auf 
Teilmenge 
BS_ISEQUAL: prüft auf 
Gleichhi 
Rückgabe: wenn Vergleich ok: TRUE, son: 













Aufruf: bs_maxcard(bs) 

Funktion: liefert maximale Kardinalität 
Parameter: bs: Zeiger auf Menge 
Rückgabe: maximale Kardinalität 
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Exget 


Die Idee zu der Funktion exget (extended get) 
kam mir beim Programmieren mit C. Alle 
Eingaberoutinen für die Tastatur, die in C be- 
reits verfügbar waren, waren relativ unkom- 
fortabel oder sogar gefährlich. 


Helmut Lehmkuhl 


nkomfortabel, weilbeim Lesen von Daten mit scanf die 
U Eingabe bei einem Whitespace (Leertaste, Tabula- 
tortaste, Return-Taste) beendet wird. Dies macht sich 
insbesondere bei Eingabe von Strings, in denen ein Leerzei- 
chen enthalten sein soll, unangenehm bemerkbar. 
Gefährlich, weil man bei Eingabe mittels gets (get String) 
zwar auch Whitespace einlesen kann, diese Funktion aber 
nicht prüft, ob man vorher genügend Speicher reserviert hat. 
Reserviert man also für die Variable, mit der man gets aufruft, 
nicht genügend Speicher, kann man leicht bei der Eingabe 
zuviel Zeichen tippen und damit unkontrolliert Werte im 
Speicher zerstören, die vielleicht noch wichtig gewesen 
wären. Die Folge kann ein Systemabsturz sein. 
Hier greift nun die Funktion exget ein. Mit ihrer Hilfe wird es 
möglich, Strings in C sehr komfortabel einzulesen. Der kor- 
rekte Aufruf lautet: 


exget(&eing, laenge, dfstr, schalter) 
Dabei müssen die Parameter wie folgt deklariert worden sein: 


char *eing 
int laenge 
int dfstr 

int schalter 


Mit laenge kann man angeben, wie lang der einzulesende 
String maximal werden darf. Hierbei ist zu beachten, daß 
man den Wert um 1 größer angeben muß als die tatsächliche 
Länge des Strings, da für das String-Endezeichen (‘\0’) ja 
auch ein Byte benötigt wird. Der String kann dann nur bis zu 
dieser maximalen Länge eingegeben werden. Versucht man 
mehr Zeichen einzugeben, ertönt eine Glocke. 

Zudem läßt sich ein Default-String auf den Bildschirm brin- 
gen, der dann ediert werden kann. Dazu muß eing schon auf 
einen String zeigen und afstr muß den Wert 1 bekommen. In 
dem Fall wertet exget den Default-String aus und gibt ihn auf 
dem Bildschirm aus. Hat der Default-String eine kürzere 
Länge als man in laenge angegeben hat, so wird /aenge auf 
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Aufruf: 


e exget(eing, laenge, dfstr) 
Funktion: 


erweiterte get-Funktion zur Eingabe und 

Editierung eines Text-Strings 

eing: Zeiger auf den String (beim 
Editieren muß der Zeiger auf 
den darzustellenden Text 


Parameter: 


zeigen) 
laenge: maximaleLängedeseinzulesen- 
den Strings 
1: String wird zum Editieren aus- 
gegeben; sonst nur Eingabe 
Rückgabewert: keiner 


dfstr: 


diese kürzere Länge gesetzt, so daß sich nur ein String bis zu 
dieser Länge eingeben läßt. Dies dient der Verhinderung des 
Hineinschreibens des Strings in wichtige Speicherstellen. 
Schließlich zeigt eing dann vielleicht nicht auf einen Spei- 
cherbereich, der groß genug ist. Will man also einen Default- 
String edieren, der kürzer als laenge ist, muß man ihn mit 
Blanks auffüllen, bis er Jaenge erreicht hat. Default-Strings, 
die länger sind als in laenge angegeben, werden nur bis 
laenge ausgegeben und können nur bis zu dieser Länge 
ediert werden. Wird afstr auf einen anderen Wert als 1 
gesetzt, wird kein Default-String ausgegeben. 

Über den Parameter schalter hat man die Möglichkeit, in der 
24sten Zeile des Bildschirms eine Ausgabe zu erzeugen, mit 
der man die Eingabe kontrollieren kann. Dazu muß schalter 
den Wert 1 erhalten. Bei allen anderen Werten erscheint 
keine Statuszeile. Hat schalter den Wert 1, wird folgendes 
ausgegeben: 


AP: XXX AL: XXX ML: XXX 


Hierbei bedeutet AP die aktuelle Position des Cursors inner- 
halb des Eingabe-Strings, AL dessen aktuelle und ML des- 
sen maximale Länge. Da diese Ausgaben bei eigenen Pro- 
grammen stören können, lassen sie sich über den Parameter 
schalter ausschalten. 

Der String kann während der Eingabe ediert werden, wozu 
man diverse Möglichkeiten zur Verfügung hat: 


<Backspace> 

Mit der Backspace-Taste wird das links vom Cursor stehen- 
de Zeichen gelöscht und der rechts vom Cursor stehende 
Text nachgezogen. Dies dürfte jedem aus der Textverarbei- 
tung hinreichend bekannt sein. 


<Delete> 

Mit der Delete-Taste wird das Zeichen, das unter dem Cursor 
steht, gelöscht und der rechts vom Cursor stehende Text 
nachgezogen. 
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<Insert> 

Mit der Insert-Taste kann man zwischen dem Überschreib- 
und dem Einfügemodus umschalten. Bei jedem Druck auf 
diese Taste wird der Modus gewechselt. Den augenblickli- 
chen Modus kann man am Cursor erkennen. Im Überschreib- 
modus hat man einen ausgefüllten stehenden Cursor, wäh- 
rend man im Einfügemodus einen ausgefüllten blinkenden 
hat. 


<Pfeil links> 
Mit dieser Taste wird der Cursor um ein Zeichen nach links 
bewegt. 


<Pfeil rechts> 
Mit dieser Taste wird der Cursor um ein Zeichen nach rechts 
bewegt. 


<CLR/HOME> oder <Shift Pfeil links> 
Mit diesen Tasten wird der Cursor auf den Anfang des 
Eingabe-Strings gesetzt. 


<Shift CLR/HOME> oder <Shift Pfeil rechts> 
Mit diesen Tasten wird der Cursor auf das Ende des Eingabe- 
Strings gesetzt. 


<Escape> 
Mit der Escape-Taste kann man die Eingabe von neuem 
beginnen. Das bis dahin Getippte (oder der Default-String) 
verschwindet vom Bildschirm, der Cursor steht am Anfang 
des Eingabefeldes. 

Esistnoch daraufzu achten, daß die Konstanten TRUE und 
FALSE deklariert werden. 


Erweiterter INPUT-Befehl 


Wer schon einmal probiert hat, eine Formula- 
reingabe in GFA-BASIC zu schreiben, kennt 
das Problem: Die INPUT-, LINE INPUT- und 
FORM INPUT-Befehle des GFA-BASIC lassen 
zwar eine komfortable Eingabe zu, aber man 
kann sie nur durch RETURN beenden. Wenn 
man die Eingabe nun z.B. mit der ‘Cursor 
hoch’- oder ‘Cursor runter’-Taste verlassen 
will, um ins nächste bzw. vorherige Feld zu 
gelangen, gibt es nur eine Möglichkeit: eine 
eigene Eingaberoutine muß her. 

normal an eine Prozedur übergibt, kann man ihn nicht 


D zurückübergeben. Wenn man ihn mit “String übergibt, 
kann man in zurückgeben, aber nicht verwenden. Also muß 
eine Methode her, um einen String hin- und rückzuüberge- 
ben. Hier ist die Lösung des ‘Hin-rück-Problems’: Von dem 
String liegt nur die Adresse vor. Um an ihn zu gelangen, muß 
man ihn zuerst in einen lokalen String in ausreichender Größe 
kopieren. Dies erledigt die Prozedur gruss). 

Wie funktioniert dieSache? Die Prozedur erhält die Adresse 
des Arrptr des Strings. Zuerst werden die nötigen Hilfsvaria- 
blen als Local definiert. Als nächstes wird die Länge des 


M.G. Berberich 





abei ergibt sich ein Problem: Wenn man einen String 


Aufruf: 
Funktion: 
Parameter: 


@input(v$, *i$, 1, C, *r) 

erweiterte INPUT-Routine 

v$: Prompttext; wird nur ausgegeben, 
kann nicht verändert werden 

i$: Eingabe-String; Inhaltwirdangezeigt 


und kann editiert werden 
Länge des Eingabe-Strings 

» Anfangsposition des Cursors 
Wert der Taste, die zum Abbruch 
geführt hat 





“übergebenen’ Strings bestimmt. Dann werden der Hilfs- 
String auf die nötige Länge mit Spaces aufgefüllt und der 
Varrptr des Strings und des Hilfs-Strings bestimmt. Beim 
Hilfs-String geht dies mit VARRPTR, beim Übergabe-String 
muß man die Adresse aus Arrptr holen. Nun kann man den 
Inhalt des Strings byteweise kopieren. Als Resultat hat man 
den String im Hilfe-String und kann ihn verarbeiten. Auf diese 
Art und Weise kann man einen String in eine Prozedur hin- 
und rückübergeben. 

Die Routine wurde in der oben angesprochenen Input- 
Routine verwendet. Sie arbeitet im Einfügemodus, was be- 
deutet, daß der Buchstabe, der gerade eingegeben wird, 
keinen anderen überschreibt, sondern an der Cursor-Positi- 
on eingesetzt wird. Die Taste Backspace löscht den links 
neben dem Cursor liegenden Buchstaben, die Taste Delete 
den rechts neben dem Cursor. Die Taste Esc löscht das 
gesamte Eingabefeld. Mit den Tasten ‘Cursor hoch’, ‘Cursor 
runter’ und ‘Return’ bzw. ‘Enter’ wird die Eingabe verlassen. 
Der Code der Taste, die den Abbruch verursacht hat, wird 
zusammen mit dem String zurückgeliefert. 
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Installieren 


von STAD-Fonts 


Leider lassen sich die Schriften von STAD, im 
Gegensatz zu GDOS-Fonts, die mit Routinen- 
aufrufen installiert und verwendetwerdenkön- 
nen, nicht ohne eine Aufarbeitung benutzen. 
Dazu können Sie das Programm STAD:GEM 
verwenden, das eine Umsetzung vom STAD- 
ins GEM-Format durchführt. 


Heinz Katzenmayer 


as Format muß deshalb geändert werden, weil bei 
D STAD jeweils die 16 Bytes eines Zeichens hintereinan- 

derliegen und danach die Daten des nächsten. GEM 
benötigt dieDaten aber imfolgenden Format: Das 1. Bytedes 
1. Zeichens, dann das 1. Byte des 2. Zeichens usw. Folglich 
ist das 257. Byte das 2. Byte des 1. Zeichens. Verstanden? 
Es klingt komplizierter, als es ist (siehe innerhalb des Pro- 
gramms). Zusätzlich zur Datenumwandlung muß ein Font- 
header für den Font angelegt werden. Allerdings muß bei 
einem neuen Font nicht der gesamte Header geändert wer- 
den. Dies ist nur an den fünf folgenden Stellen nötig: 


INSERENTENVERZEICHNIS 


Ackermann 
Adec GmbH .... 
A.FS. Software . 


Heim 
Herges .. 
Hesse 
Alternate .. 
Hintermeier 
Höfer 

Idee GmbH 
Idee Soft .. 
Issendorf .. 
Kaktus . 
Karstein- 

KFC Computer 


AS-Datentechnik 


Begemann + Niemeyer 
Bitline 

Bittner .. 
Böhnke 
BPN-Software 
Chemo-Soft 
CRP-Koruk ... 
Data Deicke 
Edicta 
Eickmann . 
EU-Soft ... 
Fischer ... 
Fröhlich .. 
GMa-Soft ... 
Graphic’s ... 


Matrix 


Meyer + Jacob . 


Plueckhahn .. 
Print Technik . 





Rees + Gabler .. 


Hard + Software Herberg 
30/31, 43, 59, 93, 96/97 


Heyer + Neumann 


1. Bytes O und 1, Font-Identifikationsnummer (hier 2bis 8, da 
1 System-Font) 

2. Bytes 4 - 35, Name des Fonts (Font-Name von STAD plus 

Zusatz ‘.STAD’ 

. Bytes 76 - 79, Adresse der Font-Daten 

. Bytes 84 - 87, Adresse des nächsten Fontheaders 

5. Bytes 66 und 67, Flag zu Kennung, ob Font System-Font 
ist 


>»@o 


Deshalb werden nur Font-Nummer und -namen zusammen 
mit den Font-Daten abgespeichert. Damit ist die Aufgabe des 
Programms STAD:GEM.GFA erledigt. Im zweiten Programm. 
F_LADEN.GFA werden nun diese Daten eingelesen. Was 
dann noch passiert, ist ziemlich einfach. Der Fontheader wird 
an den oben genannten Stellen geändert und dann zusam- 
men mit den Font-Daten an einem vorher reservierten Spei- 
cherplatz abgelegt. Es wird also eine Font-Tabelle an die 
nächste angehängt. In der letzten Tabelle wird bei der Adres- 
se des nächsten Fontheaders (siehe 4.) keine neue Adresse 
mehr eingetragen, da ja auch keiner mehr folgt. Alles, was 
sonst noch im Programm F_LADEN.GFA steht, wird nur zum 
Testen benutzt. Um das Programm nutzen zu können, muß 
man es als Unterprogramm einbauen (siehe PROC- 
FONT.GFA). Wenn man nicht alle sieben Fonts im Programm 
braucht, muß man die Zählschleife i% nur entsprechend 
verändern. 

Natürlich kann man nur bei GEM-Anwendungen diese 
Fonts nutzen (in GFA-BASIC beim Befehl TEXT, nicht bei 
PRINT). 


Rhothron 
Richter ... 


Roskothen + Eckstein . 
RTS-Elektronik .... 
Saß-Software . 
Schlichting 
Schwarzer 
Seebass .. 

Seidel .. 

Shift .... 

Sirius 

Softhansa 
SSD-Software 
SW-Software .. 


TKR .. 

Tritec .. 

1U-Me rer atneer 
VHF-Computer 

Wacker 

Wandrer 

WBW-Service . 

Wünsch 








Utilities 


Einige der wichtigsten Hilfmittel für Programmierer sind Utilities; meist kurze Programme, die dem 
Anwender Arbeit abnehmen (z.B. ein Suchprogramm nach bestimmten Strings innerhalb von 
Dateien) oder die Programmentwicklung vereinfachen (Resource-Einbindung). In dieser letzten 
Rubrik des Sonderhefts stellen wir Ihnen 14 Utilities vor. Sie finden diese (mit Ausnahme des ACS; 
dies ist ein kommerzielles Programm) auf den Disketten zum Heft. 


Festplatteninfo 
Wieviel'Platz istnochifrei.-&: 4:0 134 


Der TRAP-Trapper 
verschafft Übersicht über Betriebssystemaufrufe ....... 135 


Delbak und Find 
Zwei Utilities zum Suchen und Entfernen von Dateien 137 


Resource-Einbindung in C 
für Programme ohne RSC-File ...unueuenesesnenennnnenennnnennnnn 138 


Freier Speicherplatz 
Accessory zur Anzeige des freien Speicherplatzes.....139 


Fast-File- und Link-Viren-Finder 





Wer benötigt diese beiden Utilities nicht? ................... 140 
VIRSPY 

notiert Dateizugriffe (und Versuche) .......ueeeeeneneneneen 141 
File-Info 

Accessory zur Attributsänderung .... 142 
XBRA 

Anzeige und gezielte Desaktivierung 

von XBRA-Prögramment. 2... eseesnkeherennee 143 


Directory als Baumdiagramm 


‘Norton Utilities’-ähnliche Dateiübersicht... 143 





Wir bauen uns ein Piano 
Einfache GEM-Programmierung mit Hilfe des ACS ....144 





Memory: 188 847 555 Bytes | 
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Festplatteninfo 


Das in diesem Artikel vorgestellte Programm 
gibt Auskunft auf die Fragen, wie groß die 
gesamte Platte ist, wieviel. davon belegt ist, 
wieviel noch frei ist, wieviele defekte Sekto- 
ren markiert wurden und wie groß die einzel- 
nen Partitionen. 


Boot-Sektor der Festplatte und die GEMDO-Funktion 

Dfree(), die den freien Platz auf einem Massenspei- 
chermedium berechnet. Analog zum Boot-Sektor der Disket- 
te enthält der Boot-Sektor der Platte die vom Programm 
benötigten Informationen über die Größe der Plattesowie der 
einzelnen Partitionen. Der Boot-Sektor ist - wie bei den 
Disketten - der erste physikalische Sektor auf der Festplatte. 
Sein Aufbau ist im Listing in der Struktur BOOTBLOCK 
definiert (siehe auch in [1]). 

Das Programm muß also den Boot-Sektor lesen, um des- 
sen Inhalt auswerten zu können. Ein Problem besteht in der 
Tatsache, daß der Boot-Sektor einer Festplatte keinesfalls 
identisch ist mit dem ersten Sektor der ersten Partition (vom 
Benutzer meist als Laufwerk C angemeldet). Da man unter 
TOS nicht in der Lage ist, die gesamte Platte anzusprechen, 
muß der Programmierer einen anderen Weg, nämlich den, 
die Platte direkt anzusteuern, gehen. 

Anzusprechen ist eine Festplatteam ATARI ST nurüber den 
DMA-Chip. Er stellt die Hardware-Schnittstelle zu den exter- 
nen Massenspeichern wie Diskettenlaufwerken und Fest- 
platten dar und entlastet den Prozessor, indem er unabhän- 
gig von diesem arbeitet. Man erreicht den DMA über die in 
Tabelle 1 aufgeführten Hardware-Register (Achtung: nur im 
Supervisor-Modus!). 

Vor dem Zugriff überprüft das Programm, ob überhaupt 
zusätzliche Partitionen (und damit eine Festplatte) installiert 
sind. Danach wird der Boot-Sektor zur Auswertung eingele- 
sen. Die dazu notwendigen Schritte können Sie der entspre- 
chenden Fachliteratur (z.B. [1]) entnehmen. 

Das Programm geht alle Partitions-Einträge im Boot-Sektor 
durch. Bei Partitionen mit einem ID-Code ‘GEM’ handelt es 
sich um GEM-Partitionen. Der freie Platz auf ihnen kann 
mittels Dfree() ermittelt werden. Der freie Platz auf der kom- 
pletten Platte ergibt sich aus der Addition der freien Partiti- 
onsplätze. 


D azu verwendet das Programm die Informationen im 


Literatur: 


[1] Claus Brod/Anton Stepper, Scheibenkleister Il, MAXON Computer 
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$FF8604 Sector-Count-Register (SCR) 
Zähler fürsektorgroße Datenblöcke (512 Bytes) 


Nur an dieser Adresse, wenn Bit 4 im DMR gesetzt (= 1) ist. 
In diese Register wird die Anzahl der zu übertragenden 


Sektoren geschrieben. Es kann jederzeit gelesen werden, 
wieviele Sektoren der DMA-Chip noch übertragen muß. 


$FF8606 beim Lesen: DMA-Status-Register (DSR) 
beim Schreiben: DMA-Mode-Register (DMR) 


DMA-Status-Register: 
Die unteren drei Bits geben Auskunft über den DMA-Chip. 


BitO wird low (0), wenn ein Fehler aufgetreten ist. 

Bit 1 zeigt an, daß dasSCR auf Nullheruntergezählt 
ist. 

Bit2 wird low, sowie das /HDRQ-Signal von der 


ACSI-Schnittstelle aktiv (low) wird. 


DMA-Mode-Register: 


Bit 1 ist direkt auf den Ausgang CA1 geführt. 

Bit2 geht auf CA2. 

Bit 3 gibt an, auf welche Peripherie zugegriffen 
werden soll: 
0: Zugriff auf Register des FDC 
1: Zugriff auf den ACSI-Bus 

Bit 4 bestimmt, welches Register sich an der Adres- 
se $FF8604 befindet: 
0: Controller-Access-Register 
1: Sector-Counter-Register 

Bit6 0: DMA-Chip arbeitet. 
1: DMA-Chip arbeitet nicht. 

Bit7 0: Datenaustausch mit ACSI-Bus 
1: Datenaustausch mit FDC 

Bit 8 0: DMA-Chip liest. 
1: DMA-Chip schreibt. 

$FF8609 DMA-Adressen-Start- und Zähler-Register, 
Highbyte 

$FF860B DMA-Adressen-Start- und Zähler-Register, 
Midbyte 

$FF860D DMA-Adressen-Start- und Zähler-Register, 
Lowbyte 


Diese drei Register befinden sich eigentlich in der MMU- 
Einheit, gehören aber zum DMA-Chip. Sie sollten in der 
Reihenfolge Low- -> Mid- -> Highbyte gelesen oder be- 
schrieben werden. 








Tabelle 1: Register des DMA-Chips 
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Der TRAP-Trapper 


Auf größeren Systemen der Datenverarbei- 
tung finden sich Teile des Betriebssystems, 
die über bestimmte Ereignisse eine Art Log- 
buch führen. Für derartige Programme wird 
üblicherweise der Begriff Logger verwendet, 
eine Standardanwendung ist z.B. das Führen 
einer Fehlerliste. Als Testhilfe kann das hier 
von mir vorgestellte Programm dienen, das 
die Betriebssystemaufrufe des ATARI ST über 
die Trap-Befehle des 68000-Prozessors proto- 
kollieren kann. 


Stephan Simson 


grundsätzliche Betrachtungen anzustellen, dieich vor- 

ab kurz darlegen möchte. Zunächst muß die Program- 
mierung wegen der möglichst hohen Ausführungsgeschwin- 
digkeit in Assembler erfolgen. Weil der Start einer solchen 
Anwendung meiner Meinung nach auch aus dem AUTO- 
Ordner heraus möglich sein sollte, entfällt - leider - eine 
Realisierung als Accessory. Darüber hinaus erscheint mir 
eine Beschränkung des Protokolls auf die drei Bereiche 
GEMDOS, AES und VDI als sinnvoll, da diese die mächtig- 
sten Funktionen des Betriebssystems zur Verfügung stellen. 
Um die zu erzeugende Liste auch nach einem Systemabsturz 
mit sich anschließendem Kaltstart verfügbar zu haben, kann 
diese nicht im RAM, z.B. in einem Ringspeicher, geführt 
werden. Sie muß vielmehr dauerhaft abgelegt werden, des- 
halb entschied ich mich für die Ausgabe über einen am 
Centronics-Port anzuschließenden Drucker. Als Kennzeich- 
nungeines Betriebssystemaufrufs genügt dafür ein Buchsta- 
be ('A': AES, 'G': GEMDOS, 'V': VDI), kombiniert mit einer 
zweistelligen Zahl, die die Funktionsnummer hexadezimal 
beinhaltet. Eine auf diese Weise geführte Liste zieht aller- 
dings, trotz der kryptischen Ausgabe, einen enormen Papier- 
verbrauch nach sich und ist wohl auch in den wenigsten 
Fällen gewünscht. Deshalb mußte ich die Möglichkeit schaf- 
fen, den Ausdruck ein- bzw. auszuschalten. Zur Verein- 
fachung der Handhabung war zudem die Implementierung 
einer ebenfalls schaltbaren Zeitlupe notwendig. Auf die Steu- 
erung dieser Funktionen über die Tastatur konnte ich ver- 
zichten, da die Möglichkeit besteht, die RS232-Schnittstelle 
als 2-Bit-PlO zu benutzen. Die Funktion des residenten 
Programms sollte außerdem durch weitere Aufrufe ausge- 
setzt bzw. wieder aktiviert werden können. 


V or der Implementierung eines Loggers waren einige 


Die elementare Funktion des Loggers besteht darin, nach der 
Auslösung eines der beiden Traps die Kennung des entspre- 
chenden Betriebssystemaufrufes auszudrucken. Diese Auf- 
gabe kann dadurch gelöst werden, daß man die jeweils 
zugehörige Ausnahmebehandlung über eine entsprechende 
Routine umleitet. Geholt werden die relevanten Daten dann 
vom Stack (Trap 1) bzw. über ein Register (Trap 2). Wenn es 
doch nurso einfach wäre! Leideristeine derartige Installation 
nicht von Dauer, das Betriebssystem des ST boykottiert ein 
Verbiegen des Traps 2 gelegentlich durch Überschreiben 
des Vektors mit einem Zeiger auf sich selbst, z.B. wenn man 
sich eine Textdatei über das Desktop anzeigen läßt. Vor den 
Erfolg setzten die Götter die Reise - durch den Speicher des 
ATARI ST. Nach Lösen mehrerer Fahrkarten bei verschiede- 
nen Reiseveranstaltern bzw. Debuggern konnte ich die ge- 
suchten Übeltäter finden. Verantwortlich für die Reinitialisie- 
rung des Vektors für Trap 2 sind Teile des GEM, die durch 
Auslösung der Line-F-Ausnahme aufgerufen werden. Diese 
Ausnahmebehandlung wird beim ATARI ST im allgemeinen 
Line-F-Emulator genannt. Sie wird vom Prozessor eingelei- 
tet, sobald er erkennt, daß im nächsten auszuführenden 
Befehlswort - in diesem Zusammenhang mit Opcode be- 
zeichnet - die vier höchsten Bits gesetzt sind. Von den 
Schöpfern des GEM wurde diese Eigenschaft des 68000 
benutzt, um häufig verwendete Befehlsfolgen zu ersetzen, 
dazu gehören auch die Aufrufe der eben angesprochenen 
Routinen. Auf die Nachteile dieser Art von Programmierung 
wurde schon in mehreren Artikeln hingewiesen, für den 
Logger war sie aber durchaus nützlich. Die Arbeitsweise des 
Line-F-Emulators, beschränkt auf seinen für dieses Pro- 
gramm relevanten Teil, möchte ich kurz erläutern. 

Der Line-F-Emulator führt zwei grundsätzlich verschiedene 
Funktionen aus. Ist das niedrigste Bit des Opcodes gesetzt, 
erfolgt die Freigabeeines Stack-Bereiches über Unlink (UNLK). 
Andernfalls werden die unteren drei Bytes des Opcodes - er 
muß glatt durch vier teilbar sein - als Offset in einer Tabelle 
von Startadressen diverser GEM-Routinen interpretiert. An 
der auf diese Weise festgelegten Stelle wird das Programm 
dann mit dem Ende der Ausnahmebehandlung fortgesetzt. 
Diese stellt vorher noch den Status des Prozessors wieder 
richtig. Außerdem legt sie die Wortadresse auf dem Stack ab, 
die dem Befehl folgt, der die Ausnahme einleitete. Bei ent- 
sprechender Programmierung kann eine Anwendung die in 
Frage kommenden Routinen mittels Trace feststellen und 
ihre unerwünschten Resultate umgehen. Bei einer Installa- 
tion des so erweiterten Loggers aus dem AUTO-Ordner 
heraus verweigert das System jedoch beim Aufbau des 
Desktops unwiderruflich seine Mitarbeit. Bei genauerer Un- 
tersuchung stellte ich fest, daß nicht alle über den Line-F- 
Emulator angesprungenen Unterprogramme im Trace-Mo- 
dus durchlaufen werden können. Das Problem kann aber 
doch durch eine Kombination von Änderungen in den Rou- 
tinen für Line-F, Trace und illegale Adresse gelöst werden. 
Dabei habe ich den Umstand genutzt, daß die hier interessie- 
renden Unterprogramme mit einem Return-Befehl (RTS) ab- 
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schließen. Die Ausnahmebehandlung für Line-F 014A74 MOVE.W (A7)+,D2 ; hole Kopie des alten Status’ 
muß dann so erfolgen, daß bei Nutzung desEmu- | 014276 move.L (A7)+,A0 ; und Opcode (FXXX), Rücksprung- 
latorsalsSprungverteilerdieerzeugteRücksprung- | 014478 MovE.w (A0)+,Di ; adresse jetzt in AO, 

f Fi . s . Mr 014A7A BTST #0,D1 ; Opcode testen, gegebenenfalls 
adresse illegal ist. Bei Beendigung einer auf die- | g14a7E zue $014A94 5 ORIK-Funkbilän: {..,) ausrühren, 
sem Wege angesprungenen Routine erkennt der | o14a80 movE.w D2,SR ; sonst Status restaurieren, 
Prozessor dann die illegaleAdresseundkannden | 014282 movs.u A0,-(A7) # 'RÜCKEPTUNgSAESuRRl anf !Beacik, 
V fü fall N f 014A84 ANDI.W #$OFFF,D1 ; Adresse der 

ektor für Trap 2 gegebenenfalls wieder aufset- | gıaass MovE.L #SO0FEES6A,AO ; gewünschten Routine aus 
zen. 014A8E MOVE.L $00(A0,D1.W),AO ; der Tabelle holen und 
014A92 MP (A0) ; anspringen 


Genug der langen Einleitung, ich komme zur 


2 a Ne 014A94 
Sache. Der ausführbare Code beginnt wie üblich 


; ab hier Unlink-Funktion 








mit der Berechnung des Stackpointers und der 
Programmngröße, dann wird Trap 1 nach dem 
XBRA-Standard abgeklopft. Befindet sich das Programm 
schon resident im Rechner, wird sein Status geändert, und 
eine entsprechende Meldung erscheint auf dem Monitor. 
Andernfalls wird der Logger für GEMDOS eingerichtet, und 
das Programm bleibt nach Beendigung im Speicher. Der 
beim Rücksprung in das Betriebssystem ausgelöste Trap 1 
führt sofort wieder in die Anwendung zum GEMDOS-Logger. 
Dieser besteht aus einem ersten Teil, der die Installation für 
Trap 2 besorgen soll, und einem zweiten, der die Protokollie- 
rung für Trap 1 erledigt. Sobald das entsprechende Bit in der 
Steuervariablen ein fertig installiertes Desktop anzeigt, wird 
der erste Teil übersprungen. Solange das aber, wie auch 
beim ersten Durchlauf, noch nicht zutrifft, testet das Pro- 
gramm, ob das Desktop läuft. Dabei wird davon ausgegan- 
gen, daß nach Ende der Boot-Phase unterschiedliche Aus- 
nahmebehandlungen für Line-F und Trace existieren. Ver- 
läuft der Test negativ, wird bei den folgenden Aufrufen des 
GEMDOS geprüft, ob sowohl Line-F-Emulator als auch AES/ 
VDl zwischenzeitlich eingebunden wurden. Sobald das Desk- 
top dann läuft, wird der Merker gesetzt, und die Vektoren für 
illegale Adresse, Line-F-Emulator, Trace und Trap 2 werden 
geändert. Die Installation ist damit beendet, und die Aufrufe 
von AES und VDI werden ebenfalls über den Drucker aufge- 
listet. 

Für die Ausgabe des Protokolls wird bei Trap 1 und auch 
Trap 2 dasselbe Unterprogramm benutzt. Es beinhaltet au- 
Berdem noch die Zeitlupe und läuft über das BIOS. Zur 
Steuerung habe ich die Eingangssignale CTS (clear to send) 
und CD (carrier detect) bzw. die Ausgangssignale RTS (re- 
quest to send) und DTR (data terminal ready) der seriellen 
Schnittstelle vorgesehen. An Elektrikteilen braucht man ei- 
nen 25poligen Stecker, ein Stück Apoliges Kabel und zwei 
Schalter. Die Teile sind jetzt so zu verlöten, daß mitdemeinen 
Schalter CTS und RTS, mit dem anderen CD und DTR 
verbunden bzw. getrennt werden können. Am Parallel-Port 
des MFP 68901 kann dann die Schalterstellung gelesen 
werden. 

Was passiert nun, wenn das Betriebssystem den Line-F- 
Emulator aufruft? Die modifizierte Ausnahmebehandlung 
prüft zunächst das niedrigste Bit des Opcodes, denn wenn 
der Line-F-Emulators im Unlink-Modus benutzt werden soll, 
kann ja ab hier wie bisher verfahren werden. Ansonsten wird 
der dem aktuellen Opcode-Wert entsprechende, beim Start 
des Loggers mit $FF vorbesetzte Merker getestet. Beinhaltet 
der Merker den Wert $00, so kann eine Reinitialisierung des 
Vektors für Trap 2 durch die zuzuordnende Routine ausge- 
schlossen werden; ohne Manipulationen läuft die Ausnah- 
mebehandlung dann weiter über den Line-F-Emulator des 
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GEM. Andernfalls wird die analog zur Vorgehensweise des 
Vorbildes erzeugte Rücksprungadresse auf dem Supervisor- 
Stack abgelegt. Anschließend wird in der Kopie des auf dem 
Stack abgelegten System-Bytes das Tracebit gesetzt. Schließ- 
lich kann über den gespeicherten alten Vektor der Sprung 
zum Original erfolgen. Hier weicht der Lauf der Dinge nur 
dann vom bisher bekannten ab, wenn die Kopie des Status- 
wortes, wie beschrieben, geändert wurde. Sobald dieses 
vom Stack geholt wird, um den Prozessorstatus zu restaurie- 
ren, wird der Trace-Modus eingeschaltet. Das Trace-Pro- 
gramm prüft ab jetzt nach jedem vom Line-F-Emulator aus- 
geführten Befehl, ob der auf dem entsprechenden Stack 
befindliche Eintrag identisch ist mit dem vorher abgelegten 
Rücksprungziel. Sobald dieser Zustand erreicht ist, wird das 
niedrigste Bit der weiterhin maßgeblichen Adresse gesetzt, 
die jetzt überzählige auf dem Supervisor-Stack gelöscht. 
Dann erfolgt die Beendigung des Trace-Modus’, und der 
Aufruf dergewünschten Routine schließtsich an. Nach deren 
Abarbeitung liest der Prozessor dann einen ungeraden Wert 
als Rücksprungadresse, also eine illegale Adresse. In der 
hierdurch ausgelösten Ausnahmebehandlung wird zuerst 
überprüft, ob sie durch eine Aktion des Loggers ausgelöst 
wurde, wenn nicht, hagelt es Bomben wie üblich. Ansonsten 
berichtigt die Routine entweder den Vektor für Trap 2, oder 
der dem soeben beendeten GEM-Teil zugeordnete Merker 
wird gelöscht. Dann wird das Programm an der richtigen 
Adresse fortgesetzt. 

Zum Schluß gebe ich noch einige Anregungen zur eventuell 
nötigen Anpassung des Loggers an eine andere als die 
vorgesehene Konfiguration. Ein serieller Drucker kann relativ 
einfach angeschlossen werden, indem man die Stellung der 
Schalter über den Centronics-Port einliest. Diese Abfrage 
kann natürlich auch mit Hilfe einer /O-Karte erfolgen, aber 
die hat janun mal nicht jeder. Der kritische Punkt st sicherlich 
der Test des Desktops. Das gilt vor allem für den neuen 1040 
STE. Auf ihm, wie auch anderen Derivaten und zukünftigen 
Versionen des Betriebssystems (TOS030, PAK-68K, ...), die 
ohne Line-F-Emulator auskommen, kann der Logger in die- 
ser Form nicht zum Laufen gebracht werden. Das ist der 
Preis, den man für eine solche Programmierung zahlen muß. 


Literatur: 


[1] Service Manual Mega 1, ATARI Corp. 
[2] Brückmann, Englisch, Gerits, ATARI ST Intern, Data Becker GmbH Düssel- 
dorf 
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DelBak 
& Find 


Der Computer-User, der über sich ewig das 
Damoklesschwert des Stromausfalls oder des 
‘Daten auf Disk X defekt?’ sieht, läßt natürlich 
bei jedem Abspeichern das alte File irgendwie 
umbenennen und überschreibt es selbstver- 
ständlich nicht. Was aber, wenn nach arbeits- 
reicher Nacht alles geklappt hat und man die 
diversen BAK-, DUP-, SBK- etc. Files nicht 
mehr benötigt? 


Martin Wunderli 


Frust: Die wichstigste Datei wurde nicht korrekt ge- 

speichert, das Backup-File mittlerweile gelöscht. Aber 
irgendwo auf der Platte war doch noch eine alte Version! Nur 
wo? Schon mal durch ‘zig Ordner durchgeklickt? Womit wir 
beim 2. Utility wären: Find! 


e rund für das 1. Utility: DelBak. Und dann doch der 


DelBak 


Das 1. Utility sucht auf einem Laufwerk nach allen Dateien mit 
den Endungen BAK, DUP und SBK. Diese werden jeweils auf 
dem Bildschirm angezeigt, wo sie dann der Benutzer mit 
einer beliebigen Taste außer n/N löschen kann. Das zu 
durchsuchende Laufwerk muß beim Programmstart dem 
TTP-Programm als Argument übergeben werden. 


Beispiel: 

delbak d Alle Backups auf Laufwerk D werden gesucht, 
angezeigt und eventuell gelöscht. 

Find 


Mit dem zweiten Utility können Sie Ihre irgendwo auf dem 
Laufwerk versteckte (wer die da nur hin hat ...?) Datei wieder- 
finden. Find benötigt neben dem zu durchsuchenden Lauf- 
werk natürlich auch den Namen (ohne Extension) der zu 
findenden Datei. 


Beispiel: 

find dtest! Alle Dateien mitdem Namentest1 (z.B.test1.c, 
test1.txt, test1.bas ...), die sich auf Laufwerk D 
befinden, werden angezeigt. 
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Resource- 
Einbindun 

in C . 
Wollen Sie auf dem ATARI ST in Ihrem Pro- 
gramm ein selbsterstelltes Bild, einen neuen 
Font, eine RSC-Datei oder ein sonstiges Da- 
ten-File einbinden? Einige BASIC-Dialekte stel- 
len fürsolche Zwecke (und für Maschinenspra- 


cheroutinen) den INLINE-Befehl zur Verfügung. 
Was aber z.B. in ‘C’ und Assembler machen? 


Christoph Conrad 


inige Resource-Construction-Sets bieten die Möglich- 
F keit, die Resource-Datei als C-Quelltext auszugeben. 

Dieses Feature bieten aber nicht alle Resource-Con- 
struction-Sets, außerdem erfordert dieser Weg einen mehr 
oder weniger großen Anpassungsaufwand. Andere Daten- 
Files können Sie eigentlich nur zur Laufzeit des Programmes 
dazuladen, oder mit einem Hilfsprogramm in ein C-Quelltext- 
File umwandeln, in dem ein global initialisiertes char-Array 
die Bytes des Daten-Files aufnimmt. Eine andere Möglichkeit 
zeigt das Programm RSC2OBUJ.TTP (lies: Resource to 
OBJEKT.TTP) auf, die gerade beim Einbinden von Resource- 
files sehr elegant ist. Die vom Programm erwartete Kom- 
mandozeile lautet: infile outfile labelname [-r]. infile ist der 
Dateiname des zu konvertierenden Daten-Files. outfile ist die 
konvertierte Objektdatei. labelname ist der Name des öffent- 
lichen Labels, unter dessen Adresse Sie Ihre Daten an- 
sprechen (siehe Beispielprogramm). 

Um die Arbeitsweise des Konverters zu verstehen, müssen 
Sie etwas über den Aufbau von Objektdateien, wie Sie 
Compiler und Assembler erstellen, wissen. Die vorliegenden 
Betrachtungen sind teilweise etwas vereinfacht und be- 
schränken sich auf den für Sie wesentlichen Aspekt. Das auf 
dem ATARI ST von den gängigen Compilern/Assemblern 
benutzte Format ist jenes von Digital-Research (GEM stam- 
mt auch daher). In diesen Objekt-Files sind die Größen des 
Codes, der initialisierten und der uninitialisierten Datenberei- 
che vermerkt sowie die Code- und Datenbereiche abgelegt. 
Unsere Daten-Files landen komplett im Datensegment der 
erzeugten Objektdatei; die Größe des Datenbereiches ent- 
spricht der des Daten-Files. Codegröße und Größe der 
uninitialisierten Datenbereiche werden auf Null gesetzt. Wei- 
terhin gibt es eine Symboltabelle, die hauptsächlich Auskunft 
gibt über die Namen von Variablen, welche Sie aus einem 
Programm-Modul exportieren bzw. importieren, und die Art 
der Variablen. Ein Beispiel: Sie definieren in einem C-Modul 
eine Variable global (außerhalb jeder Funktion), z.B. int flag. 
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Aufbau einer Digital-Research-Objectdatei 
Bx6BiR 

TEXT-Size 
DATA-Size 
BSS-Size 
Syntablesize | long ssize; 





int nagic; 





long tsize; 





Header long dsize; 





long bsize; 


reserved | char reservedL10]; 


TEXT (Code) 





char tbytes[tsize]; 











Bild 1: Der 
DATA (Daten) | char dbytesldsizel; Aufbau einer 
Synboltable | char symboltablelssizel; | Digital- 

Research- 


Fixuptable 


char fixupltsizetdsizel; 





Objektdatei 





Aufbau eines Sunboltabelleneintrages 
iter Eintrag... 
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Sunboltyp Sunbolnert 


SYMBOLTYP 

in der BSS 

in Code 

in den Daten 
External 
Register 
Globales Symbol 
Equated 
Defined 


HERT 

8x8108 
0x8208 
0x0400 
0x8808 
0x1008 
0x2008 
8x4000 
0x8080 


kann z.B, eine Adresse, Registernunner,, 
der Wert eines Ausdrucks etc, sein, 
Der erste Eintrag des Beispiels bedeutet 


also folgendes: 
OxA400 = 0x8000+0x2000+0x0400 


also Defined global in Datensegnent , 





Bild 2: Der Aufbau eines Symboltabelleneintrags 


Diese Variable soll in einem zweiten Programm-Modul be- 
nutzt werden und wird dort als extern int flag deklariert. Der 
Linker weiß nun aus der Symboltabelle des Objekt-Files von 
Modul 2, daß in einem anderen Modul eine Variable flag 
existieren muß und findet diese in der Symboltabelle des 
Objekt-Files von Modul 1. Der Label-Name, den Sie über die 
Kommandozeile angegeben haben, wird in der Symboltabel- 
le vermerkt als "global definiert im Datensegment" mit dem 
Symbolwert 0. Dies bedeutet, daß die Adresse dieses Labels 
direkt auf die Daten (ohne Versatz) zeigt. 

Den für uns wichtigsten Teil des Objekt-Files (zumindest bei 
RSC-Dateien) stellt die Fixup-Tabelle dar. Programme kön- 
nen zur Laufzeit vom Betriebssystem an ganz unterschiedli- 
che Startadressen geladen werden, eben dort, wo gerade 
genug Platz frei ist. Aus Codegröße- und Geschwindigkeits- 
gründen benutzen Compiler (und Assembler-Programmie- 
rer) aber viele Maschinenbefehle, die auf eine feste Adresse 
(z.B. einer Variablen) zugreifen, und zwar so, als begänne der 
Code/die Daten ab Speicheradresse 0. Das bedeutet z.B.: 
Falls ein Label relativ zum Codesegmentstart $4711 Bytes 
entfernt liegt, ist im compilierten Maschinencode (Objektda- 
tei) die Zugriffsadresse $4711. Dem Linker kann aberüber die 
Fixup-Tabelle gesagt werden, daß er für solche Zugriffe 
Einträge im fertigen Programm in der sogenannten Reloka- 
tionstabelle macht. Der Lader (das ist die Komponente des 
Betriebssystems, welches ein Programm von Diskette/Platte 
lädt und alle nötigen Anpassungen vornimmt) wertet solche 
Einträge aus und addiert bei allen solchen absoluten Adres- 
sen dietatsächliche Startadresse des Codes (er 'reloziert' die 
Adressen). Die Fixup-Tabelle ist genauso groß wie die Grö- 
Ben von Code- und Datensegment zusammengenommen. 
Jede zu relozierende Adresse (Länge =4 Bytes = 1 Long) wird 
durch 4 Bytes in der Fixup-Tabelle vermerkt, wobei der 
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Abstand des Longs vom Fixup-Tabellenanfang genau dem 
Abstand des zu relozierenden Longs vom Start des Code- 
bzw. Datensegments entspricht. Für die Konversion sind 
zwei beschreibende Werte der Fixup-Tabelle wichtig: 
0x00000000 und 0x00050001. Der erste Wert führt dazu, das 
der Linker in der Relokationstabelle des fertig gelinkten 
Programms einen Wert einträgt, der dem Lader "bitte dieses 
Wort (long) nicht verändern!" mitteilt. Der zweite Wert sagt 
dem Linker, daß es sich um ein zu relozierendes Long im 
Datensegment handelt, was er entsprechend in der Reloka- 
tionstabelle berücksichtigt. Bei reinen Daten-Files [KEIN 
Switch -r (l)] wird die gesamte Fixup-Tabelle mit Nullen 
aufgefüllt, es sollen ja auch keine Daten vom Lader verändert 
werden. Bei Resourcefiles existieren eine Menge interner 
Zeiger, z.B. auf TEDINFOs, ICONBLKs, BITBLKs sowie in- 
nerhalb dieser Strukturen Zeiger auf Daten etc. (siehe [2],[6]). 
Alle diese Zeigerwerte beziehen sich aber auf den Anfang der 
Resource-Datei und werden von rsrc_load(..) beim Einladen 
der Resourcedaten auf die absoluten Speicheradressen durch 
Addition der RSC-Speicherbasisadresse angepaßt. Na, 
klingelt’s? Das ist ja genau dasselbe wie beim Relozieren! 
Wenn wir in der Fixup-Tabelle diese Zeiger als relozierbar 
markieren, wird der Lader uns alle RSC-internen Zeiger 
setzen. 

Die einzige zur Laufzeit notwendige Anpassung besteht in 
der Umrechnung von Zeichen- in Pixel-Koordinaten. In Re- 
sourcefiles sind nämlich die Positionen und Abmessungen 
der Objekte nicht in Pixeln, sondern in Zeichenbreiten bzw. 
Zeichenhöhen angegeben, wobeinoch ein vorzeichenbehaf- 
teter Byteoffset (-128..127) einen Pixel-Versatz angeben 
kann. Diese Umrechnung kann sehr bequem mittels der 
AES-Funktion rsrc_obfix(..) gemacht werden. Die Funktion 
rsrc_gaddr(..) muß durch eine eigendefinierte Funktion er- 
setzt werden, da die Originalfunktion auf Daten im global- 
Array zurückgreift, die durch rsrc_load gesetzt werden. 

Bei der Konversion von Resourcefiles (Flag -r) wird sicher- 
heitshalber noch ein kleiner Test vorgenommen, ob es sich 
wirklich um ein Resourcefile handelt, damit beim versehent- 
lichen Setzen dieses Flags normale Daten-Files durch die 
Relokationsinformationen nicht verunstaltet werden. Aber 
nicht nur deswegen: Sämtliche relativen Zeiger beziehen 
sich auf den Resource-Dateistart (wie schon erwähnt) und 
können deshalb auch nicht negativ sein. Die für die Konver- 
sion allokierten Speicherbereiche liegen meist direkt hinter 


dem Konversionsprogramm im Speicher (an höheren Adres- 
sen). Negative Zeiger-Offsets (das sind bei normalen Daten- 
Files fälschlicherweise als Zeiger-Offsets aufgefaßte Daten) 
könnten (beim 'Poken' der Fixup-Werte in den dafür allozier- 
ten Buffer) das Konversionsprogramm teilweise überschrei- 
ben und zu Programmabstürzen führen. Details zum Aufbau 
der Resource-Dateien würden den Rahmen dieses Artikels 
bei weitem sprengen. Ich verweise speziell auf [2],[3] und 'die 
Bibel‘ [6]. 

Im Programm setze ich zur Behandlung von Ausnahmesi- 
tuationen (sprich Fehlern) 'Goto's ein. Da Sie diesen Satz 
noch lesen, darf ich davon ausgehen, das Sie nicht zu den 
absoluten Anti-'Goto'-Puristen gehören, welche sicherlich 
gerade damit beschäftigt sind, diesen Artikel fein säuberlich 
aus dieser Zeitung herauszutrennen. Daß 'Goto's zum Ver- 
lassen tief verschachtelter Kontrollstrukturen gut geignet 
sind und eine Menge überflüssiger if-Abfragen ersparen, hat 
sich jazum Glück herumgesprochen. Aber auch bei Fehlern 
ersparen Sie es sich, jedesmal den Ausnahmebehand- 
lungscode durchzulesen, was das Verständnis der eigent- 
lichen Programmabsicht doch erheblich stört. Außerdem 
sind alle Fehlerbehandlungsmaßnahmen übersichtlich am 
Ende einer Routine gesammelt. 

Zum Beispielprogramm können Sie eine beliebige, mit 
einem Resource-Construction-Set erstellte und durch den 
Konverter geschleuste Re- source-Datei dazulinken. Der 
Label-Name sollte recource sein. Das Programm zeigt Ihnen 
alle Objektbäume zentriert auf dem Bildschirm. Menüleisten 
werden normalerweise nicht zentriert; hier schon, da das 
Programm nicht wissen kann, ob Ihre Resource eine Menü- 
eiste enthält. Bei Menüs bleibt etwas Pixel-Schrott am 
oberen Bildschirmrand. 


Literatur: 


1] Jürgen Schultz-Kappler, Dialog über Tasten, c't 3/88 

[2] Stefan Höhn, Objektstrukturen im AES, ST-Computer Sonderheft 2 (sehr 
informativ und verständlich!) 

[3] Stefan Höhn, Einführung in das Resource-Construction-Set von Digital 
Research, ST-Computer Sonderheft Nr. 2 

[4] Jürgen Leonhard, Resource-Datei? Nein dankel, ST-Computer 12/87 

[5] Lutz Preßler, Resourcen in GFA-Basic 3.0, ST-Computer 10/88 

[6] Jankowski/Reschke/Rabich, ATARI Profibuch ST-STE-TT, Sybex Verlag 





Freier Speicherplatz 


Jürgen Stessun 


schaften: Zum einen zeigt es nach Aufruf den noch im 

Rechner vorhandenen freien Speicher an, und zum 
zweiten istes nur etwas mehr als 500 Bytes lang. RAM_FREE 
wird, wie jedes Accessory, zur Installation in den ROOT- 
Ordner der Boot-Partition kopiert. Bei Bedarf kann es dann 
durch Anklicken in der Menüzeile aktiviert werden. 


D as Accessory RAM_FREE hat zwei nützliche Eigen- 


Memory: 114342 Bytes 
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Fast-File- und 
Link-Viren-Finder 


Vor einiger Zeit war es mal wieder soweit: Ich 
suchte das Backup von einem Source-Text auf 
einer der 10 Partitions meiner Megafile 60. 
Aber in welchem Ordner befand es sich? Eine 
Szene später: Habe ich nun einen Link-Virus 
auf der Platte oder nicht? Sagrotan starten und 
warten, ... 


iesich der geneigte Leser sicherlich vorstellen kann, 
W habe ich für beide Probleme eine Lösung anzubie- 

ten - und zwar in Form eines Fast-File-Finders bzw. 
des Link-Virus-Finders: 

Der Fast-File-Finder (FFF) ist in der Lage, die gesamte 
Festplatte nach einem Dateinamen zu durchsuchen. Ganz 
nebenbei ermittelt er auch noch, wieviel Platz auf jeder 
Partition noch frei ist. 

Der Link-Virus-Finder (LVF) durchsucht alle ausführbaren 
Programme auf der Festplatte nach Link-Viren. Er tut dies, 
indem er den Programm-Header mit den Mustern des VOS 
und des Milzbrand-Virus’ vergleicht. Beim jedem Programm 
wird zudem eine Prüfsumme über die ersten 256 Bytes 
berechnet, mit welcher bei jedem neuerlichen Start vom LVF 
verglichen wird. Ach ja, der LVF braucht für meine 10 Parti- 
tions (mit über 2800 Dateien in mehr als 280 Ordnern) etwa 
13.5s, um festzustellen, ob Link-Viren vorhanden sind oder 
nicht. Ich denke, daß ist im Vergleich zu 15 min bei Sagrotan 
angenehm schnell ... 

Kommen wir nun zum Eigentlichen: dem Programm. Wie 
man leicht feststellen kann, ist das Programm in Assembler 
geschrieben. Es besteht aus einigen Teilen, die man auch 
prima einzeln verwenden kann. Deshalb glaubeich, daß jeder 
Assembler-Programmierer etwas von dem Listing hat. Es ist 
recht gut dokumentiert. 

Da der FFF und der LVF in wesentlichen Teilen gleich sind, 
gibt es nur ein Listing, aus welchem man mit dem Flag virus 
wahlweise den FFF oder den LVF erzeugen kann. 

Um ein Laufwerk nach Link-Viren oder Dateien zu durchsu- 
chen, wird zuerst die Routine set_drive() für das zu durchsu- 
chende Laufwerk aufgerufen. Diese Routine ermittelt den 
BPB des Laufwerkes, liest die FAT und ermittelt so ganz 
nebenbei noch dessen freien Speicherplatz. 

Nun wird read_dir() aufgerufen. Diese Routine liest das 
Root-Directory des Laufwerkes ein und ruft für jeden Ordner 
die Routine read_sub_dir() auf. Diese Routine liest dann 
rekursiv alle weiteren Ordner ein. 
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Der Speicherplatz für die Ordner wird durch die Routine 
get_mem|) ermittelt, die eine Heap-Verwaltung darstellt. Das 
Prinzip eines solchen Heaps ist sehr einfach: Man hat einen 
Zeiger auf einen großen Speicherblock - den Heap. Will nun 
jemand Speicher allozieren, wird dieser Wert des Zeigers 
zurückgegeben. Das ist die Adresse des Speicherblockes, 
den man angefordert hat. Bevor das Unterprogramm verlas- 
sen wird, erhöht man diesen Zeiger noch um die Größe des 
angeforderten Speicherblockes, so daß bei einem erneuten 
Aufruf der Zeiger hinter den ersten Speicherblock zeigt. 

Noch zwei Dinge gilt es zu beachten: Die Größe des 
Speicherblockes sollte aufgerundet werden, damit dieser 
stets auf einer geraden Adresse anfängt. Und man sollte 
abfragen, ob der Zeiger hinter den Speicherblock zeigt, der 
für den Heap reserviert ist. Wenn dem so ist, reicht der 
Speicher nicht, und das Programm wird abgebrochen. 

Jetzt wird sich der eine oder andere eventuell noch fragen: 
Wie kann man denn Speicherblöcke wieder freigeben? Die 
Antwort ist ganz einfach: gar nicht! Das ist bei unserem 
Directory-Baum auch gar nicht nötig, da wir vor jedem 
erneuten Einlesen eines Baumes den Heap-Pointer einfach 
wieder zurück auf den Anfang setzen und somit alle Blöcke 
freigegeben haben. 

So, nach diesem Ausflug in die Heap-Verwaltung kommen 
wir zur Routine hunt_dir(). Siedurchsuchteinen eingelesenen 
Directory-Baum nach Dateien bzw. die Dateien nach Viren. 
Auch diese Routine funktioniert rekursiv, d.h. wenn ein Ord- 
ner gefunden wird, ruft sie sich mit einem Zeiger auf den 
Ordner und der Anzahl der Dateien des Ordners erneut auf. 
Wenn der Ordner komplett durchsucht wurde, wird zurück- 
gekehrt, und es geht weiter. 

In dieser Routine besteht auch der größte Unterschied 
zwischen dem FFF und dem LVF. Während der FFF den 
Dateinamen nur mitseiner Suchmaske vergleicht und den ihn 
mit Pfad gegebenenfalls ausgibt, hat der LVF erheblich mehr 
zu tun. Wenn ein erster Vergleich der Extensions „PR?“, 
„TO?“, „TT?“, „AC?“, „AP?“, „DR?“ (Treiber), „SY?“ (Fest- 
plattentreiber!) positiv ist, wird der erste Sektor dieser Datei 
eingelesen. Bei einer Programmdatei müssen am Anfang die 
Bytes $601A stehen. Nun wird der Anfang des TEXT-Seg- 
mentes mit den zwei bekannten Link-Viren verglichen. 

Wenn kein Link-Virus vorhanden ist, wird eine Prüfsumme 
über die ersten 256 Bytes der Datei berechnet. Dies klingt 
zwar nach sehr wenig, wenn man bedenkt, daß z.B. Sagrotan 
eine CRC-Prüfsumme über die gesamte Datei berechnet, 
reicht aber, da in den ersten 256 Bytes die Länge der 
einzelnen Programmsegmente steht, welche durch einen 
Virus an sich immer verändert wird. Zudem mußsich ein Virus 
am Programmanfang aufrufen, und über genau diese Stelle 
wird die Prüfsumme ja auch berechnet. Wie man sieht, wird 
zwar Zeit gespart, aber die Sicherheitistimmer noch gewähr- 
leistet. 
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Nach der Berechnung der Prüfsumme wird in der Vergleichs- 
liste nach dem Programm gesucht. Wenn das Programm 
bereits in der Liste steht, wird die Prüfsumme in der Liste 
gesucht, denn für jedes Programm merkt sich der LVF bis zu 
sieben Prüfsummen. Das ist sehr praktisch, wenn man z.B. 
verschiedene Programmversionen auf der Festplatte hat. 
Wenn die Prüfsumme nicht in der Liste steht, wird gefragt, ob 
die neue Prüfsumme mit in die Liste aufgenommen werden 
soll. Steht der Programmname noch nicht in der Liste, wird 
ein neuer Eintrag für das Programm angelegt und eine 
entsprechende Meldung ausgegeben. Die Vergleichsliste 
wird beim Start vom LVF automatisch geladen, und sie kann 
vor dem Programmende natürlich auch geschrieben werden. 

SowohlLVF als auch auf FFF können in der Kommandozeile 
einige Parameter übergeben werden. 

Mit einem „-“ am Anfang der Kommandozeile wird die 
Ausgabe der Dateinamen unterdrückt. Beim LVF spart es 
einfach Zeit, beim FFF ist es lediglich dann praktisch, wenn 
man nur wissen wollte, wieviel „*.TXT“-Dateien z.B. auf der 
Festplatte stehen, aber nicht, wo sie sind. Eventuell hat man 
den FFF auch nur gestartet, um festzustellen, auf welcher 
Partition noch Platz ist, denn das wird ja praktischerweise 
auch ausgegeben. 
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Mit einem „+“ wird beim LVF eine unbekannte Datei odereine 
unbekannte Prüfsumme automatisch, d.h. ohne Rückfrage, 
übernommen. Das ist insbesondere dann praktisch, wenn 
man den LVF zum ersten Mal, also ohne die „LVF.DAT“-Datei 
startet. 

Sowohl beim LVF als auch beim FFF kann man mit „:x“ nur 
das Laufwerk „x“ durchsuchen lassen. Beispiel: „:C*, es wird 
nur das Laufwerk C: durchsucht. Ansonsten wird ab Lauf- 
werk „C:“ bis zum letzten benutzten Laufwerk alles durch- 
sucht - also üblicherweise die gesamte Festplatte. 

Beim FFF kann man nun noch eine Suchmaske angeben. 
Diese kann ein kompletter Dateiname wie z.B. „TEST.DOC“ 
sein oder aber auch nur ein Teil davon („T*.D?C“), wie beim 
GEMDOS also. 


Literatur: 


[1] Scheibenkleister Il, MAXON Computer 
[2] Atari Profibuch ST-STE-TT, Sybex 
[3] Anleitung zum TurboAss 


Der GEMDOS-Türwächter 


Wem ist so etwas noch nicht passiert: Man 
kopiert sich ein Programm auf die RAM- oder 
Harddisk, aber es beschwert sich nach dem 
Starten darüber, daß noch irgendein File feh- 
le. Meistens liegt es an falschen Suchpfaden 
oder Namen. 





Gerrit Gehnen 


dem die Diskettenoperationen auf dem Drucker mit- 

geschrieben werden. Außerdem: Wen interessiertes 
nicht, ob sein Lieblings-Compiler irgendwelche Zwischen- 
dateien anlegt und wo sie erzeugt werden? Nebenbei ist 
VIRSPY ein Lehrstück zum Schreiben von residenten Pro- 
grammen mit XBRA-Protokoll und sauberer Installation. VIR- 
SPY fängt die GEMDOS-Aufrufe ab, die in solchen Fällen 
benutzt werden, nämlich Pexec(), Fopen(), Fcreate() und 
Sfirst(). Allerdings hatte VIRSPY ursprünglich eine ganz an- 


M it VIRSPY hat man ein Werkzeug in der Hand, mit 


dere Aufgabe (wie schon der Name sagt), nämlich die Suche 
nach Link-Viren, die sich an Programme anhängen und von 
da aus munter weiterverbreiten. 

In der Routine, die zwischen Benutzer (Programm oder 
Desktop) und GEMDOS eingeschoben wird, werden diese 
Funktionen analysiert und der dazu passende Pfad- und File- 
Namen auf dem Drucker protokolliert. Wem nach erfolgrei- 
cher Analyse das Druckergeratter zuviel wird, braucht nicht 
einen Reset auszulösen, sondern nur VIRSPY noch einmal zu 
starten; dadurch wird ein Flag umgesetzt, mit dem die 
Druckerausgabe gesteuert wird. 

Zum GEMDOS hin ist Virspy vollkommen transparent, d.h. 
alles, was vorne reingeschickt wird, kommt auch hinten 
wieder raus (wenn auch mit einer kleinen Verzögerung wegen 
der Druckerausgabe). 

Bei der Entwicklung habe ich auf möglichst geringen Spei- 
cherverbrauch geachtet: die Installationsroutine fliegt, nach 
getaner Arbeit, raus. Wer sich ein wenig mit der Parameter- 
ausgabe ans GEMDOS auskennt, dem dürfte esnichtschwer- 
fallen, das Programmauf weitere Funktionen auszuweiten 
und damit noch flexibler zu machen. 
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PROGRAMMIERTIPS 


File-Info 


Jeder ST-Besitzer kennt selbstverständlich die 
Option “zeige Info” im Desktop-Menü. Für 
eine ausgewählte Datei erscheint beim Aufruf 
eine Dialogbox, die Informationen über diese 
anzeigt. Dabei handelt es sich um Angaben 
über den Dateinamen, Erstellungsdatum und - 
zeit sowie über das Schreibschutzattribut. Än- 
dern lassen sich leider nur dieses Attribut und 
der Dateiname. 


[a 


ill man jedoch die Erstellungszeit oder andere Attri- 
W bute ändern, läßt sich nichts machen. Dabei ist es 

manchmal sinnvoll, nachträglich das Erstellungsda- 
tum einer Datei ändern zu können, z.B. dann, wenn ssichnach 
einem Kopiervorgang zeigt, daß man wieder einmal verges- 
sen hat, die Uhr im Kontrollfeld zu stellen. Das Ergebnis: Die 
Datei weist ein unsinniges Erstellungsdatum auf. Bisher blieb 
in einem solchen Fallnichts anderes übrig, als den Kopiervor- 
gang zu wiederholen (natürlich nach dem Stellen der Uhr), mit 
einem Disk-Monitor zu drohen oder sich gar ganz geschla- 
gen zu geben. 





Seimet 


Einstellungen 


Mit dem Accessory FILEINFO ist dieser Ärger nun vorbei. Für 
die über den Fileselector angewählte Datei erhält man eine 
ausführlichere Information als das Desktop sie bietet, wobei 
alle angezeigten Angaben auch geändert werden können. 
Neben dem Schreibschutzattribut kann eingestellt werden, 
ob es sich bei der ausgewählten Datei in Zukunft um eine 
Systemdatei oder um eine versteckte handeln soll. Zur Aus- 
wahl der Attribute genügt es, die dafür vorgesehen Buttons 
in der Dialogbox anzuklicken. Die Einstellung der Buttons 
beim Betreten der Box entspricht den Attributen, wie sie die 
Datei im Augenblick des Aufrufs besitzt. Besonders interes- 
sant sind die Dateiattribute System und Versteckt, die vom 
Desktop aus nicht geändert werden können. Geben Sie einer 
Datei das Attribut System, wird sie nicht mehr auf dem 
Desktop angezeigt, und auch für den normalen Fileselector 
ist sie nicht mehr vorhanden. Dennoch kann der Inhalt dieser 
Datei gelesen werden, denn sie ist nicht wirklich von der 
Diskette verschwunden. Wozu das gut sein kann? Nun, wenn 
Sie Disketten besitzen, die hoffnungslos überfüllt sind, geben 
Sie allen .RSC-Dateien doch einfach den Systemstatus. 
Danach sieht der Disketteninhalt schon viel übersichtlicher 
aus, denn die .RSC-Dateien werden nicht mehr angezeigt. 
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Das Betriebssystem bzw. die Programme, die die .RSC- 
Dateien lesen sollen, bemerken von der Änderung nichts. 
Selbstverständlich kann man dieses Verfahren auch auf 
andere Dateien anwenden, die nur von anderen Programmen 
nachgeladen werden, also ohnehin nicht über einen Maus- 
klick gestartet werden können. Geben Sie einer Datei das 
Attribut Versteckt, so ist sie für das TOS so gut wie gar nicht 
mehr zu finden, es sei denn, man geht mit einem Disk- 
Monitor auf die Suche. 


Kopierschutz 


Auf diese Art und Weise kann ein einfacher Kopierschutz für 
einzelne Dateien realisiert werden, denn wenn man nicht 
weiß, daß sich eine Datei auf einer Diskette befindet, kommt 
man auch nicht auf die Idee, sie kopieren zu wollen. (Selbst- 
verständlich hilft dieses Verfahren nur dann, wenn nicht 
gleich ein Backup der kompletten Disk gemacht wird.) Dar- 
aus resultiert jedoch auch folgende Warnung: Merken Sie 
sich, welche Dateien Sie versteckt haben, denn nur wenn Sie 
die Dateinamen kennen, können Sie diese Files wieder sicht- 
bar machen! Hierzu rufen Sie erneut das FILEINFO-Acces- 
sory auf, geben den Namen der unsichtbaren Datei über die 
Tastatur ein (der Fileselector zeigt diesen Namen nicht an!), 
und voila: Die Information über die anscheinend nicht vor- 
handene Datei erscheint auf dem Bildschirm. Ändern Sienun 
die File-Attribute entsprechend ab, wird die Datei ab sofort 
wieder für jedermann sichtbar. 

Wichtig istnoch derfolgende Hinweis: Wird die Datei, deren 
Namen oder Attribut Sie soeben geändert haben, in einem 
Window auf dem Desktop angezeigt, muß die ESC-Taste 
gedrückt werden, damit die vorgenommenen Änderungen 
auf das Desktop übertragen werden. Welche Routinen des 
GEMDOS ermöglichen nun das Holen und Ändern der File- 
Daten? Für das Holen und Setzen der File-Attribute ist die 
Funktion CHANGE MODE ($31) verantwortlich. Sie ermög- 
licht das Setzen oder Löschen einzelner Attribute. Erstel- 
lungsdatum und -zeit werden mit der Funktion GSDTOF ($57) 
geholt oder gesetzt. Als Parameter wird unter anderem ein 
Flag übergeben, das bestimmt, ob die Daten ermittelt oder 
gesetzt werden sollen. 








PROGRAMMIERTIPS 


ABRA 


Das Programm XBRA.TOS zeigt Ihnen alle, 
mittels XBRA-Verfahren installierten Program- 
me auf, die sich in Systemvektoren einge- 
hängt haben. Sie haben dann die Möglichkeit 
einzelne Programme zu deaktivieren. Beden- 
ken Sie dabei aber, daß Sie das Programm 
zwar aus der Vektor-Routine aushängen, es 
von nun an nicht mehr aufgerufen wird, der 
vom Programm reservierte Speicher, und na- 
türlich der vom Programm belegte, jedoch 
nicht freigegeben wird. 


Andreas Kohler 


Directory 
als Baum- 
diagramm 


Das Desktop stellt mit seinen Fenstern zwar 
komfortabel Ausschnitte der Ordnerstruktur dar, 
möchte man aber einen Überblick über das 
gesamte Directory einer Diskette oder gar ei- 
ner Festplatten-Partition gewinnen, reicht die 
Darstellung nicht mehr aus. Eines der ‘Norton 
Utilities’ (für PCs) stellt u.a. die Ordnerstruk- 
tur als Baumdiagramm dar, genau dies leistet 
auch das hier vorgestellte Programm. 


LEZRUNTGIN 


Man übergibt ihr in vec die Adresse einer Systemvaria- 

blen. Der Inhalt der Systemvariablen und Ihre Adresse 
werden zunächst auf Plausibilität geprüft, der Zugriff auf eine 
nichtexistierende oder ungerade Adresse würde nämlich 
zum Absturz führen. Sollte die in die Systemvariable einge- 
tragene Routine dem XBRA-Standard entsprechen, so liefert 
die Funktion 1 zurück und legt in name die Programmken- 
nung und in next die Adresse des nächsten Routinezeigers 
ab, sonst wird 0 zurückgeliefert. Beim nächsten Aufruf von 
getxbra() kann der Wert von next wieder in vec übergeben 
werden, um die XBRA-Kette weiter zu verfolgen. Ein Beispiel 
für dieses Vorgehen finden Sie in der Funktion prnpage!(). 

un_link() entfernt aus allen XBRA-Ketten die Routine mit der 
Programmkennung id. Sollte die Kennung mehrmals in der 
Kette auftauchen, wird nur der erste Eintrag (d.h. das zuletzt 
installierte Programm) entfernt. Nicht alle Systemvektoren 
stehen an einer festen Adresse, manchmal muß diese auch 
erst erfragt werden. Ein Beispiel dafür findet sich in varinit(). 
Nach dem Start zeigt das Programm die XBRA-Ketten für 

eine Reihe von wichtigen Systemvektoren an. Die Umschal- 
tung der Seiten durch direkte Eingabe der Seitennummer ist 
möglich. Will man nun ein Programm ‘aushängen’, so kann 
man nach der Anwahl der Option R die Programmidentifika- 
tion eingeben (Klein- und Großbuchstaben werden unter- 
schieden). Nach einer Rückfrage entfernt das Programm die 
Routine mit dieser ID aus allen Ketten. Mit der Escape-Taste 
können Sie das Programm beenden. 
Z Dateibaum gezeichnet werden soll. Danach wird das 

Ausgabegerät bestimmt. Die Bildschirmausgabe läßt 
sich mit der linken Maustaste anhalten, mit der rechten geht 
es weiter. Bei der Datei-Ausgabe muß man noch den Namen 
der Ausgabedatei eingeben. Beim Ausdruck erfolgt keine 
Anpassung der Sonderzeichen (hier ‘|’ und ‘\'). Diese muß 
man für seinen Drucker evtl. noch selber einfügen. 


K ernstück des Programms ist die Funktion getxbra(). 


unächst wird der Pfad ausgewählt, von wo aus der 


Wie wird das Baumdiagramm 
gezeichnet? 


Da Bäume rekursive Datenstrukturen sind, geht man beim 
deren Aufbau und Zeichnen am einfachsten auch rekursiv 
vor. Die Prozedur direktory_zusammensuchen() ruft sich so- 
lange selber auf, bis keine weiteren Dateien mehr gefunden 
werden. Zur Dateisuche werden die GEMDOS-Funktionen 
Fsfirst() und Fsnext() verwendet. Fsfirst() durchsucht das 
aktuelle Directory nach Dateien, auf die der angegebene 
Name paßt. Dabei bestimmt der zweite Parameter attribut, 
nach welchem Dateinamen gesucht werden soll (16 bedeutet 
hierbei, daß auch nach Ordnern gesucht werden soll). Fs- 
next() setzt die Suchefort. Die Prozedur dateinamen_bestim- 
men|) liest schließlich den Dateinamen aus. 
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PROGRAMMIERTIPS 


Der Ton 'A' 


Ein Blick in die Atari-Dokumentation (oder entsprechende 
Fachliteratur) verrät uns, daß mit dem XBIOS-Aufruf Do- 
sound() die Soundgeneratoren angesteuert werden. Dazu 
muß ein Zeiger auf einen String übergeben werden, der den 
Soundchip programmiert. Details mag der interessierte Le- 
ser der entsprechenden Literatur entnehmen. Uns soll hier 
genügen, daß der Stringsound genau diestut, unddaß ander 
Position 1 das Low-Byte und an der Position 3 das Highbyte 
des Teilers einzutragen ist. Die Frequenz wird durch die 
Formel 125000Hz / Teiler bestimmt. Unsere musikerzeugen- 
de Routine ton muß also den Benutzerzeiger USERPT aus 
dem erweiterten Objekt ermitteln, um daraus den Teiler zu 
berechnen. Um möglichst wenig Genauigkeit zu verlieren, 
wurden die Werte vor der Division mit 1000 multipliziert. 
Anschließend wird die Routine Dosound() aufgerufen. So, 
nun brauchen wir nur noch den Compiler zu starten und 
können, ohne daß wir uns um die Fensterverwaltung direkt 
gekümmert haben, bis zu sieben PIANO-Fenster öffnen und 
uns, bei Anwahl der Taste (mittels Maus oder durch Drücken 
von A auf der Tastatur), am Ton A erfreuen. 

Leider werden wir beim Ausprobieren, vor allem bei Ver- 
wendung der Tastatur, eine Unschönheit feststellen: die 
Tasten klicken, und die Tastenwiederholung ist auch unpas- 
send. Außerdem ist die visuelle Rückmeldung (Invertierung 
der Taste) doch ein sehr kurz geratenes Blinzeln. Und wenn 
wir schon bei Verbesserungsvorschlägen sind: Wie wäre es, 
wenn das Programm auch als Accessory laufen würde, 
wobei genau unser PIANO-Fenster erscheinen würde. Und 
außerdem haben wir natürlich immer noch die Erzeugung 
eines ‘richtigen’ Keyboards im Hinterkopf. 


Tastaturklick 


In der Initialisierungs-Routine ACSinit() können mit Hilfe der 
Variablen conterm der Tastaturklick und die Tastenwieder- 
holung ausgeschaltet werden. Als ordentliche Programmie- 
rer merken wir uns den Wert dieser Variablen und restaurie- 
ren ihn beim Verlassen des Programmes. Hierzu dient die 
‚ACSterm-Routine, die zum Abschluß des Programms durch- 
laufen wird. Um die visuelle Rückmeldung deutlicher zu 
gestalten, fügen wir in die Routine ton einfach eine Warte- 
schleife ein, die 80 Millisekunden wartet. 


Keyboard 


Für ein ‘richtiges’ Keyboard benötigen wir noch einmal den 
ACS-Editor. Mit seiner Hilfe bauen wir ein schönes Keyboard 
auf (Bild 1). Für die weißen Tasten benutzen wir als Auslöse- 
tasten die untere Tastenreihe von '<‘ bis ‘-’, für dieschwarzen 
die entsprechenden Tasten der Reihe darüber. Außerdem 
wird für die Startphase als Accessory das Fenster PIANO als 
Root-Fenster festgelegt. 

Wenn wir nun das übersetzte Programm starten, erhalten 
wir in der Tat ein Keyboard, das, mit der Tastatur bedienbar, 
Töne spielt [Wie Sie vielleicht gemerkt haben, haben wir an 
der Routine ton() zur Erzeugung des Sounds nichts geändert! 
Den benötigten Parameter für die verschiedenen Tonhöhen 
werden ja jeweils vom ACS in die erweiterte Objektstruktur 
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Bild 3: Notwendige Einträge in die erweiterte Objektstruktur 


eingetragen und von unserer Routine ausgelesen; sofern Sie 
beim Erzeugen der neuen Tasten den jeweiligen Wert in 
USERP1 eingetragen haben]. 

Nachdem Sie ein so schönes Keyboard besitzen und be- 
reits einige Melodien gespielt haben, kommt Ihnen vielleicht 
der Gedanke, ob man nicht das Spielen aufnehmen könnte, 
um es ein weiteres Mal zu hören. 


Rekorder 


Wir müssen dazu Tastenanschläge speichern und später 
wieder abspielen. Dazu definieren wir im ACS-Editor zwei 
neue Buttons: STARTund PLAY.START spult quasi ein Band 
an den Anfang; man hätte es auch als Löschen bezeichnen 
können. PLAY wiederholt alle Tastenanschläge. Da wir für 
das Band einen Eintrag in der Komponente USER des 
Fenstera benötigen, die wir bei Beenden des Fensters auch 
wieder freigeben müssen, muß nun auch eine eigene Ser- 
vice-Routine angelegt werden. In die Komponente USER 
tragen wir erst zur Laufzeit eine dynamisch erzeugte Struktur 
ein, die zur Aufnahme der Tastenfolge dient. 

Wenden wir uns dem Applikationsteil zu. Selbstverständ- 
lich definieren wir auch die Prototypen der neuen Routinen. 
Wie soll die Datenstruktur aussehen, die die Anschläge 
speichert? Wirlegen einfach ein Feldan, dessen Einträge aus 
einer Struktur aus Index und Zeitpunkt bestehen. Außerdem 
muß noch ein Zeiger auf den nächsten zu schreibenden 
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Eintrag verwaltet werden. Die Strukturtape leistet genau das. FENSTER EDITOR 

Die create-Routine piano_make() muß mittels Ax_malloc() Pr n 
die Datenstruktur tape anfordern, die in der Komponente sI16 5 [® ] 
USER des Fensters eingetragen wird. Die Initialisierung darf 
nicht vergessen werden. 

Da beim Beenden des Fensters korrekterweise auch die 
eigenen Daten freizugeben sind, müssen wir eine eigene Mae CI UPARRON ee | 
Terminier-Routine angeben. Sie ist sehr einfach. Wenn das CLOSER DNARROH Bleibt 
System dem Fenster die Aufforderung zum Terminieren DULLER LE = Sn 
sendet (AS_TERM), werden die USER- und die Fensterstruk- INFO RTARROW Ninnt an 
tur freigegeben. SIZER VSLIDE 

Die Routine start() ist ebenfalls sehr einfach. Sie setzt nur FENSTER TExTE 
den Schreibzeiger auf den ersten Wert zurück. Ai — 

Die Routine ton() muß so ergänzt werden, daß der Index des = I5| Bild 4a 
angewählten Objektes und der aktuelle Zeitpunkt gespei- |* Tolr| und. 
chert werden. Als Zeitgeber verwenden wir den eingebauten 
200Hz-Timer. Er ist für unsere Zwecke mit 5 ms Auflösung 
genau genug. pi FENSTER EDITOR 1 

Die Routine play() spielt das Band wieder ab. Es wird PIANO INFO RTARRON Hiaten r 
gewartet, bis der Zeitpunkt zum Spielen des nächsten Tones SIZER VSLIDE 
eintritt. Teile der Routine ton() können hier übernommen me 
werden. Zur visuellen Unterstützung werden die entspre- NAHE: Piano _ 
chenden Taste invertiert, als wären sie wirklich gedrückt INFO: 
worden. Wichtig ist, daß die Schleifen abbrechbar gestaltet il Far ost Lasenen 
werden. Im Beispiel erlauben beliebige Maustasten einen MENU: 

Abbruch. Bann... REIS 

Nach dem Compilieren steht die neue Version zur Verfü- USER Bes re se 
gung. Was, Sie wollen noch mehr? Abspeichern und Laden, ee 
Editieren der Töne und Zeiten, veränderbare Parameter des OPEN oO oo. .. Bild 4b: 
Soundgenerators, Transponieren, Einstellen der Geschwin- BEER piano_nake_____.. Der- 
digkeit usw. Nun, dies sollte ja nur als Beispiel dienen. Weiter Fenster- 
Ergänzungen müssen Sie schon selbst durchführen ... ® Editor 
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rat reicht Original ATARI Diskettenlaufwerke(7?OKB) ıntern. DM IIl-/ extern anschlußfertig: DM 166.- 


Schon wieder kleinere Preise | 


alle HD Stalionen ab sofort günstiger. Festplatten-Kits bıs zu DM IOO - günstiger ! 


Mega STE - mit HD-Drive Al-Tastatur 


Ein Mega STE ohne HD-Laufwerk ist wie ein Porsche ohne Räder (=unsere Meinung), für ST, STE und TT. Eine der be- 
deshalb gibt's bei uns die Mega STEs gleich mit HD-Laufwerk (72OKB und 1.44MB, sien Tasialuren. die Cherry 
siehe unten). Preis des Mega STE mit | MByle RAM und HD-Laufwerk: 1444,- G80/ 000 gibi's jeizi an- 


schlußfertig(I) für Ihren ATARI. 
Was $ie für's HD-Laufwerk mehr bezahlen, Festplatten (eingebaut): Kein Lölen oder IC-Tauschen | 
können Sie hier wieder sparen: mit 48 MB Piatie +444,- Anschließen - ferlig | Dank 
mit 52 MB Platie +633,- neuem Prozessor auch noch 
mit 85 MB Platte +T- 


schneller. Mehr dazu im Info: 
mil 2 MByte RAM +IL- mit X05 MB Platie +888,- gleich kostenlos anfordern. 
mil 4 MByle RAM +255,- mit 2/0 MB Platie +1444,- 


Tip: SPAREN Sie DM 345,- gegenüber EZ-Preis bei Kauf mit Farb-Multiscan FMA 14-II nur DM 249,- 


‚Aufpreise für mehr Speicher: 


HD-Diskettenstationen 


HD-Diskettenstationen, die auch 1.44MB verarbeiten, sind heufe das MUSS für einen 
modernen Compuler. Die Gründe: 1.) doppelt so viel Speicherplatz pıo Dis- 
kelte; 2.) doppeli so schnelle Datenübertragung: 3) IBM-Disketienformate können 
gelesen werden (außer mil urallern TOS); 4.) sehr günstiges Speichermedium Il! 

5.) voll kompatibel zu 720KB Disketten (also normales Arbeilen wie bisher; 6) sehr 
hochwerlige Qualität (alle Laufwerke von TEAC |) zum günstigen Preis. Um die HD- 
Option zu nutzen, wird das HD-Modul benöligt. 


EXTRAS 


dyn. Mouse für ST,STE u.TT T,- 
oplische Mouse für ST,STEUTT  IIL- 
„Scanner 400 DPI, |0Smm 39,- 
AI-SPEED CK 422.- 
166,- 


Versand per NN, europaweit 
und Direktverkauf in Hannover 


Coprozessor für AT-SPEED CI6 
1MByie SIMM für alle STE 
Coprozessor für Mega STE 
Coprozessor für Mega ST 
Megafile 44 mit Medium 
Laserdrucker für STSTE u.TTab 1694,- 
FMA 14-Il Multiscan 194,- 
dio. zus.mit Mega STE +849,- 
Neu: SM 144 für ST 333,- 
Einschaltverzögerung 9- 
leiser Lüfler für Mega ST 
Hypercache*, I6MHz 
Lieferbar: WD 1772 02-02 


3,5° HD-Station zum Einbau incl. Anleitung 
3.5” wie vor mit ddd HD-Modul 

3.5” exlerne HD-Station anschlußferlig 
3.5” wie vor mit ddd HD-Modul 


DM 199.- 
DM 885.- 
DM 96.- 
DM 355,- 


.25° HD-Siation zum "Einbau" incl. Anleitung DM 49.- 
5.25” wie vor mit ddd HD-Modul DM 99.- 
5.25" exierne HD-Siation anschlußfertig DM 222 - 
5.25” wie vor mil ddd HD-Modul DM 277.- 
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estplatten für ST, STE und. 


Die ddd MicroDisk ist eine sehr kleine anschlußfertige externe Festplatte (siehe Bild, Abbildung I:). Bei der 
Entwicklung dieser Festplattengeneralion wurde besonders auf hohe Zuverlässigkeit und lange Lebensdauer Werl 
gelegt. So verwenden wir z.B. lüngsgeregelle Neizteile (eingebaut) anstatt anfälliger Schaltnetzteile, erreichen 
durch gute Kühlung gerade 25 Grad Celsius Laufwerksiemperatur (entscheidend für Datensicherheit und 
Lebensdauer) anstatt 40 oder gar 60 Giad, verwenden kugelgelagerie Lüfter für leisen Lauf und lange 
Lebensdauer, verwenden VDE-gerechie Bauteile zu Ihrer Sicherheit, puffem DMA-In und OUT, haben den SCSI- 
Bus herausgeführt und benutzen einen der schnellsten Controller. Alles Technik, die man nicht auf den ersien Blick 
sieht, aber schnell zu schätzen leıni. Design, Größe und Farbe passend zur HD-Diskstation. 


Abbildung in Originalgröße Prei sstu Iz 





Der Controller 
Speziell für höchste Ge- 
schwindigkeit entwickelt, 
garantieren wir einen Inter- 
leave von I und erreichen 
Übertragungsraten bis über 
1500 KByle/s. Integrierler 
Hardwareschreibschutz zur 
Sicherheit vor Viren (verges- 
sen Sie Passwörter I). Bis zu 7 
Festplatten anschließbar. 
Adressen von außen bzw. 
durch Software einstellbar 
(s.Software) Echtzeituhr 
‚baugleich dem Mega ST) 
nachrüstbar. 


AlaralTHlelfefein] 


Die Software 

Der Treiber ist voll Alari AHDI 
AO kompatibel. Neu: Dusch 
Cache bis SI2KB (einstellbar) 
um bis zu Faklor 3.4 schnel- 
ler | Neu: Softwaremäßige 
Unit-Adresseinstellung (52er 
u. Ser). Voll autoboolfähig 
von jeder Partition. Jede 
MicroDisk wird komplett 
eingerichiet geliefert, also 
anschließen, einschalten 
und sofort arbeiten (wie mit 
Disketten, nur bis zu 50 mal 
schneller). 


Die Laufwerke 
Zum Einsatz kommen 


ausschließlich modernste 
35” SCSI-Drives von 
Seagate und Quantum. 
Aber Achtung: Quantum ist 
nicht gleich Quantum I Wir 
verwenden nur die 
Laufwerke der neuen LPS 
Serie mit 1" Bauhöhe 
aufgrund des geringeren 
Laufgeräusches und der 
höheren Geschwindigkeit. 
Alle Laufwerke haben 
Hardware-Aulopark-Funk- 
tion, parken überflüssig. 


Öffnungszeiten: MO. - FR. von © - 18 Uhr durchgehend 
Samstag und Sonntag geschlossen. 


digital dakı deicke. einer der weltweit größten Anbieter im ST-Bereich rät: Achten Sie auf guien technischen Suppor 


Die Preise 
dad-MicroDisk 48 
mit Seagale ST 157N-I 
DM 794, - (655) 


ddd-MicroDisk 52 
mit Quantum LPS 52 5 
DM 922, - 666.) 


ddd-MicroDisk 85 
mit Seagate ST IO96N 
DM 1055, - (794,,) 


dad-MicroDisk 05 
mit Quantum LPS 105 S 
DM 1222, - (944-) 


NEU. Atarı SM 144 (S/W, 14”) eısetzt den kleinen SM !24 Unser Preis. ATARI SM 144 ıncl Drehfuß 





RAM, also Hauptspeicher kann 
ein Computer eigentlich gar- 
nicht genug haben. 
4MB hat Atari für die 
Computer der ST Serie 
vorgesehen. Wollen Sie 
auch 4MB in Ihrem 
Atari ST Computer ha- 
ben? Kein Problem! 
Mit der stromsparen- 
den CMOS 4MB Spei- 
chererweiterungskarte 
IMEX4 kann jeder 
Atari ST Computer auf 
4MB erweitert werden. 





Ein paar Features: 


Sie benutzen Ihren Mega 
ST nicht nur zum spielen, 
sondern arbeiten ernsthaft 
mit ihm? Manchmal wün- 
schen Sie sich, daß der 
Computer schneller wäre, 
oder wollen Sie sogar einen 
Floating-Point Coprozessor 
verwenden? Dann brauchen 
Sie keinen neuen Computer 
sondern einen professionel- 
len Hardwarebeschleuniger. 
Der hier vorgestellte HBS 
240 arbeitet mit 16MHz 
Taktfrequenz und hat einen 
16KB Cache Speicher on board! 
Damit erreicht ein normaler 
Mega ST eine Beschleunigung 
von ca. 1.8 bis 2.0. Damit wir 


77x43mm winzig 
12 Monate Garantie 


Kompatibel!!! 
Ihr Mega ST dann genauso modernste 4Mbit ZIP 
schnell wie ein neuer Mega Rams 
STE. Sie wollen nicht die Katze Insiderinformation: 


im Sack, Sie wollen objektive 
Information? Dann fordern Sie 
einfach den Nachdruck eines 


‚Ein 1040ST benötigt 
im 5V Zweig ca. 1.7A. 
Nach dem Einbau 


Testberichts an, natürlich kos- eine 

tenlos. auf ca. 1.4A!! 
HBS 240 299.- Einbauservice 100.- 
Aufpreis für NVDI 60. IMEX4 Den 
Aufpreis für FPU 200.- 


Ausgewählt servicefreundliche und erfahrene Fachhändler: 
DATASOUND DIGIT UniCom SX GmbH 
Schillerpromenade 24 Mühlgasse 19 Eisenbahnstr. 93 
'W-1000 Berlin 44 W-6903 Neckargemünd 0-7050 Leipzig 
030/6228604 06223/72095 +37/0/41/65523 


JOTKA Computing BV. 
Vening Meinesz 1 
NL-6717 AJ Ede 
+31/0/8380/21675 





Kein ST muß länger ohne 
Harddisk sein! Wir bieten 
anschlußfertige Festplatten in 
jeder Größe und für jeden 
Geldbeutel. Ein paar allgemeine 
Features: 


- deutsche Anleitung 

- anschlußfertig, ready to go 

- externer DMA und SCSI Bus 
- interne Echtzeituhr 

- thermogeregelter Lüfter 

- inklusive aller Kabel 

- inklusive Backup Software 


HD 32 999,- 
HD 105 1255.- 
HD 210 1888.- 
HD 330 3099.- 
HD 425 3099.- 
HD 660 4222.- 
HD 1200 3539.- 
WP 44 1255.- 
WP 88 1755.- 





Shift GmbH 
Kompagniestr. 13 
W-2390 Flensbur; 
0461/2282 









5 Richterswil 
[7848947 








